跟 我 学 Spring 
系 钾 





跟 我 学 Spring 系列 

















目录 

介 # 
跟 我 学 Spring3 : 
【第 二 章 】loC 之 2.1IoC 基 础 ~ 跟 我 学 Spring3 
【第 二 章 】 IloC 之 2.2 loC 容器 基本 原理 一 一 跟 我 学 Spring3 12 
【第 二 章 】 1oC 之 2.3 loC 的 配置 使 用 一 “ 跟 我 学 Spring3 
【第 三 章 】DI 之 3.1 DI 的 配置 使 用 一 一 跟 我 学 spring3 bs 
【第 三 章 】 DI 3 
【第 三 章 】 DI 之 3.3 更 多 DI 的 知识 一 一 跟 我 学 spring3 
【第 三 章 】 DI 2 7 
【第 四 章 】 资源 之 4.1 基础 知识 跟 我 学 spring3 
【第 四 章 】 资源 之 4.2 内 置 Resource 实 现 一 一 跟 我 学 spring3 1.9 
【第 四 章 】 资源 之 4.3 访问 Resource 一 一 跟 我 学 spring3 1.10 
【第 四 章 】 资源 之 4.4 Resource 通 配 符 路 径 一 一 跟 我 学 spring3 1.11 
【第 五 章 】Spring 表 达 式 语言 之 5.1 概述 5.2 SpEL 基 础 一 跟 我 学 spring3 1.12 
【第 五 章 】Spring 表 达 式 语言 之 5.3 SpEL 语 法 一 一 跟 我 学 spring3 人 
【第 五 章 】Spring 表 达 式 语言 之 5.4 在 Bean 定 义 中 使 用 EL 一 跟 我 学 spring3 ”1.14 
【第 六 章 】AOP 之 6.1 AOP 基 础 一 — 跟 我 学 spring3 bs 
【第 六 章 】AOP 之 6.2 AOP 的 HelloWorld 一 跟 我 学 spring3 “10 
【第 六 章 】 AOP 之 6.3 基于 Schema 的 AOP 一 一 跟 我 学 spring3 1.17 
【第 六 章 】AOP 之 6.4 基于 @AspectJ 的 AOP 一 一 跟 我 学 spring3 1.18 
【第 六 章 】 AOP 之 6.5 AspectJ 切 入 点 语法 详解 一 一 跟 我 学 spring3 1.19 
【第 六 章 】 AOP 之 6.6 通知 参数 一 一 跟 我 学 spring3 1 
【第 六 章 】 AOP 之 6.7 通知 顺序 一 一 跟 我 学 spring3 ee 
【第 六 章 】AOP 之 6.8 切面 实例 化 模型 一 跟 我 学 spring3 a 
[第 六 章 】AOP 之 6.9 代理 机 制 __ 跟 我 学 spring3 -9 
【第 七 章 】 对 JDBC 的 支持 之 7.1 概述 一 一 跟 我 学 spring3 J24 
【第 七 章 】 对 JDBC 的 支持 之 7.2 JDBC 模 板 类 一 一 跟 我 学 spring3 1.25 
【第 七 章 】 对 JDBC 的 支持 之 7.3 关系 数据 库 操作 对 象 化 一 一 跟 我 学 spring3 1.26 
【第 七 章 】 对 JDBC 的 支持 之 7.4 Spring 提供 的 其 它 帮助 一 一 跟 我 学 spring3【 私 部 
在 线 原创 】 人 
【第 七 章 】 对 JDBC 的 支持 之 7.5 集成 Spring JDBC 及 最 佳 实践 一 跟 我 学 spring3 


跟 我 学 Spring 系列 




















【第 八 章 】 对 ORM 的 支持 之 8.1 概述 一 一 跟 我 学 spring3 129 28 
【第 八 章 】 对 ORM 的 支持 之 8.2 集成 Hibernate3 一 一 跟 我 学 spring3 1.30 
【第 八 章 】 对 ORM 的 支持 之 8.3 集成 iBATIS 一 一 跟 我 学 spring3 1.31 
【第 八 章 】 对 ORM 的 支持 之 8.4 集成 JPA 一 一 跟 我 学 spring3 1.32 
【第 九 章 】 Spring 的 事务 之 9.1 数据 库 事务 概述 一 一 跟 我 学 spring3 9 
【第 九 章 】 Spring 的 事务 之 9.2 事务 管理 器 一 一 跟 我 学 spring3 Le 
【第 九 章 】 Spring 的 事务 之 9.3 编程 式 事务 一 一 跟 我 学 spring3 1 
【第 九 章 】 Spring 的 事务 之 9.4 声明 式 事务 一 一 跟 我 学 spring3 1.36 
【第 十 章 】 集 成 其 它 Web 框 架 之 10.1 概述 一 一 跟 我 学 spring3 J 
【第 十 章 】 集 成 其 它 Web 框 架 之 10.2 集成 Struts1.x 一 一 跟 我 学 spring3 1.38 
【第 十 章 】 集 成 其 它 Web 框 架 之 10.3 集成 Struts2.x 一 一 跟 我 学 spring3 1.39 
【第 十 章 】 集 成 其 它 Web 框 架 之 10.4 集成 JSF 一 一 跟 我 学 spring3 Le) 
【第 十 一 章 】 SSH 集 成 开发 积分 商城 之 11.1 概述 一 _ 跟 我 学 spring3 1.41 
【第 十 一 章 】 SSH 集 成 开发 积分 商城 之 11.2 实现 通用 层 一 一 跟 我 学 spring3 1.42 
【第 十 一 章 】 SSH 集 成 开发 积分 商城 之 11.3 实现 积分 商城 层 一 一 跟 我 学 spring3 

【第 十 二 章 】 零 配置 之 12.1 概述 一 一 跟 我 学 spring3 1.44 1.43 
【第 十 二 章 】 零 配置 之 12.2 注解 实现 Bean 依 赖 注 入 一 一 跟 我 学 spring3 
【第 十 二 章 】 零 配置 之 12.3 注解 实现 Bean 定 义 一 一 跟 我 学 spring3 


【第 十 二 章 】 零 配置 之 12.4 基于 Java 类 定义 Bean 配 置 元 数据 一 一 跟 我 学 spring3 











【第 十 二 章 】 零 配置 之 12.5 综合 示例 -积分 商城 一 一 跟 我 学 spring3 1.48 1.47 
【第 十 三 章 】 测试 之 13.1 概述 13.2 单元 测试 跟 我 学 spring3 1.49 
【第 十 三 章 】 测试 之 13.3 集成 测试 跟 我 学 spring3 1.50 
跟 我 学 Spring MVC 2 
SpringMVC + spring3.1.1 + hibernate4.1.0 集成 及 常见 问题 总 结 2.1 
Spring Web MVC 中 的 页 面 缓存 支持 一 跟 我 学 SpringMVC 系 列 2.2 
Spring3 Web MVC 下 的 数据 类 型 转换 (第 一 篇 ) 一 一 《 跟 我 学 Spring3 Web MVC》 
抢先 看 2.3 
Spring3 Web MVC 下 的 数据 格式 化 (第 二 篇 ) 一 一 《 跟 我 学 Spring3 Web MVC》 抢 
先 看 2.4 
第 一 章 Web MVC 简 介 涛 学 SpringMVC 2.5 
第 二 章 Spring MVC 入 门 一 一 跟 开 涛 学 SpringMVC 2.6 
第 三 章 DispatcherServlet 详 解 一 一 跟 开 涛 学 SpringMVC 2.7 
第 四 章 Controller 接 口 控制 器 详解 (1) 一 一 跟着 开 涛 学 SpringMVC 2.8 
第 四 章 Controller 接 口 控制 器 详解 (2) 一 一 跟着 开 涛 学 SpringMVC 2.9 


跟 我 学 Spring 系列 


第 四 章 Controller 接 口 控制 器 详解 (3) 一 跟着 开 涛 学 SpringMVC 2.10 
第 四 章 Controller 接 口 控制 器 详解 (4) 一 一 跟着 开 涛 学 SpringMVC 2.11 
第 四 章 Controller 接 口 控制 器 详解 (5) 一 一 跟着 开 涛 学 SpringMVC 2.12 
跟着 开 涛 学 SpringMVC 第 一 章 源 代码 下 载 2.13 
第 二 章 Spring MVC 入 门 源 代码 下 载 2.14 
第 四 章 Controller 接 口 控制 器 详解 源 代 码 下 载 2.15 
第 四 章 Controller 接 口 控制 器 详解 (6) 一 一 跟着 开 涛 学 SpringMVC 2.16 
第 四 章 Controller 接 口 控制 器 详解 (7 完 ) 一 一 跟着 开 涛 学 SpringMVC 2.17 
第 五 章 处 理 器 拦截 器 详解 一 一 跟着 开 涛 学 SpringMVC 2.18 
源 代码 下 载 第 五 章 处 理 器 拦截 器 详解 一 一 跟着 开 涛 学 SpringMVC 2.19 
注解 式 控制 器 运行 流程 及 处 理 器 定义 第 六 章 注解 式 控 制 器 详解 一 一 跟着 开 涛 学 
SpringMVC 2.20 
源 代码 下 载 第 六 章 注解 式 控制 器 详解 2.21 
SpringMVC3 强 大 的 请 求 映 射 规则 详解 第 六 章 注解 式 控制 器 详解 一 一 跟着 开 涛 学 
SpringMVC 2.22 
Spring MVC 3.1 新 特性 生产 者 、 消 费 者 请 求 限定 一 一 第 六 章 注解 式 控制 器 详解 
一 一 跟着 开 涛 学 SpringMVC 2.23 
SpringMVC 强 大 的 数据 绑 定 〈1) 一 一 第 六 章 注解 式 控制 器 详解 一 一 跟着 开 涛 学 
SpringMVC 2.24 
SpringMVC 强 大 的 数据 绑 定 (2) 一 一 第 六 章 注解 式 控 制 器 详解 一 一 跟着 开 涛 学 
SpringMVC 2.25 
SpringMVC 数 据 类 型 转换 一 “第 七 章 注解 式 控制 器 的 数据 验证 、 类 型 转换 及 格式 化 
一 一 跟着 开 涛 学 SpringMVC 2.26 
SpringMVC 数 据 格式 化 一 一 第 七 章 注解 式 控制 器 的 数据 验证 、 类 型 转换 及 格式 化 
一 跟着 开 涛 学 SpringMVC 2.27 
SpringMVC 数 据 验证 一 一 第 七 章 注解 式 控制 器 的 数据 验证 、 类 型 转换 及 格式 化 一 
跟着 开 涛 学 SpringMVC 2.28 


跟 我 学 Spring 系列 


跟 我 学 Spring3 


作者 : 开 涛 


来 源 : 跟 我 学 spring3 


【第 二 章 】 loC 之 2.1loC 基 础 一 跟 我 学 
Spring3 


2.1.1 IloC 是 什么 


loc 一 Inversion of Control， 即 “控制 反 转 ”， 不 是 什么 技术 ， 而 是 一 种 设计 思想 。 在 Java 开 发 

中 ，loc 意 味 着 将 你 设计 好 的 对 象 交 给 容器 控制 ， 而 不 是 传统 的 在 你 的 对 象 内 部 直接 控制 。 如 
何 理解 好 loc 呢 ? 理解 好 loc 的 关键 是 要 明确 * 谁 控制 谁 ， 控 制 什么 ， 为 何 是 反 转 〈 有 反 转 就 应 

该 有 正 转 了 ) ， 哪 些 方面 反 转 了 "， 那 我 们 来 深入 分 析 一 下 : 


e@ 谁 控制 谁 ， 控 制 什么 : 传统 Java SE 程 序 设 计 ， 我 们 直接 在 对 象 内 部 通过 new 进 行 创 建 对 
象 ， 是 程序 主动 去 创建 依赖 对 象 ; 而 loC 是 有 专门 一 个 容器 来 创建 这 些 对 象 ， 即 由 loc 容 器 来 控 
制 对 象 的 创建 ; 谁 控制 谁 ? 当然 是 loC 容器 控制 了 对 象 ; 控制 什么 ?2 那 就 是 主要 控制 了 外 部 资 
源 获 取 (不 只 是 对 象 包括 比如 文件 等 ) 。 

e@ 为 何 是 反 转 ， 哪 些 方面 反 转 了 : 有 反 转 就 有 正 转 ， 传 统 应 用 程序 是 由 我 们 自己 在 对 象 中 主动 
控制 去 直接 获取 依赖 对 象 ， 也 就 是 正 转 ; 而 反 转 则 是 由 容器 来 帮忙 创建 及 注入 依赖 对 象 ; 为 
何 是 反 转 ? 因为 由 容器 帮 我 们 查找 及 注入 依赖 对 象 ， 对 象 只 是 被 动 的 接受 依赖 对 象 ， 所 以 是 
反 转 ; 哪些 方面 反 转 了 ?依赖 对 象 的 获取 被 反 转 了 。 


用 图 例 说 明 一 下 ， 传 统 程序 设计 如 图 2-1， 都 是 主动 去 创建 相关 对 象 然后 再 组 合 起 来 : 





人 EE 动 创建 E 动 创建 
\ 
客户 端 类 
1、 创 建 用 户 类 
2、 创 建 用 户 信息 类 
3、 将 用 户 信息 类 主动 注入 到 用 户 类 


图 2-1 传统 应 用 程序 示意 图 





当 有 了 IloC/DI 的 容器 后 ， 在 客户 端 类 中 不 再 主动 去 创建 这 些 对 象 了 ， 如 图 2-2 所 示 : 


> 


| 用 户 类 一 用 户 信息 类 


Ne 主动 创建 


IoC 容 器 
1、 创 建 用户 类 
2、 看 用 户 类 是 否 有 依赖 对 象 需 要 注入 
3、 有 用 户 信息 类 需要 注入， 首先 创建 用 
户 信息 类 ， 然 后 将 其 注入 到 用 户 类 
4、 由 容器 管理 这 些 对 象 的 生命 周期 





上 [am 用 


客户 端 类 
直接 从 容器 获取 用 请 类 


图 2-2 有 loC/DI 容 器 后 程序 结构 示意 


1.1.2 loC 能 做 什么 


loC 不 是 一 种 技术 ， 只 是 一 种 思想 ， 一 个 重要 的 面向 对 象 编程 的 法 则 ， 它 能 指导 我 们 如 何 设计 
出 松 耦 合 、 更 优良 的 程序 。 传 统 应 用 程序 都 是 由 我 们 在 类 内 部 主动 创建 依赖 对 象 ， 从 而 导致 
0 高 耦合 ， 难 于 测试 ; 有 了 loC 容 器 后 ， 把 创建 和 查找 依赖 对 象 的 控制 权 交 给 了 容 

， 由 容器 进行 注入 组 合 对 象 ， 所 以 对 象 与 对 象 之 间 是 松散 耦合 ， 这 样 也 方便 测试 ， 利 于 功 
复 用 ， 更 重要 的 是 使 得 程序 的 整个 体系 结构 变 得 非常 灵活 。 


GE 本 


DZ 水 


其 实 loC 对 编程 带 来 的 最 大 改变 不 是 从 代码 上 ， 而 是 从 思想 上 ， 发 生 了 “ 主 从 换 位 ”的 变化 。 应 
用 程序 原本 是 老大 ， 要 获取 什么 资源 都 是 主动 出 击 ， 但 是 在 loC/DI 思 想 中 ， 应 用 程序 就 变 成 被 
动 的 了 ， 被 动 的 等 待 |loC 容 器 来 创建 并 注入 它 所 需要 的 资源 了 。 


loC 很 好 的 体现 了 面向 对 象 设 计 法 则 之 一 雹 法则 :“ 别 找 我 们 ， 我 们 找 你 ”; 即 由 loC 
容器 帮 对 象 找 相应 的 依赖 对 象 并 注入 ， 而 不 是 由 对 象 主动 去 找 。 





2.1.3 loC 和 DI 


DI 一 Dependency Injection， 即 “依赖 注入 ”: 是 组 件 之 间 依 赖 关系 由 容器 在 运行 期 决定 ， 形 象 
的 说 ， 即 由 容器 动态 的 将 某 个 依赖 关系 注入 到 组 件 之 中 。 依 赖 注入 的 目的 并 非 为 软件 系统 带 
来 更 多 功能 ， 而 是 为 ee 的 频率 ， 并 为 系统 搭建 一 个 灵活 、 可 扩展 的 平台 。 通 过 
依赖 注入 机 制 ， 我 们 只 需要 通过 简单 的 配置 ， 而 无 需 任何 代码 就 可 指定 目标 需要 的 资源 ， 完 
成 自身 的 业务 逻辑 ， I 资源 来 自 何 处 ， 由 谁 实现 。 


理解 DI 的 关键 是 :“ 谁 依赖 谁 ， 为 什么 需要 依赖 ， 谁 注入 谁 ， 注 入 了 什么 ”， 那 我 们 来 深入 分 析 
一 下 


e@ 谁 依赖 于 谁 : 当然 是 应 用 程序 依赖 于 IloC 容 器 ; 

@ 为 什么 需要 依赖 : 应 用 程序 需要 loC 容 器 来 提供 对 象 需要 的 外 部 资源 ; 

e@ 谁 注入 谁 : 很 明显 是 loC 容 器 注入 应 用 程序 某 个 对 象 ， 应 用 程序 依赖 的 对 象 ; 

e@ 注 入 了 什么 : 就 是 注入 茶 个 对 和 象 所 需要 的 外 部 资源 (包括 对 象 、 资 源 、 常 量 数据 ) 。 


loC 和 DI 由 什么 关系 呢 ?其实 它 们 是 同一 个 概念 的 不 同 角 度 描述 ， 由 于 控制 反 转 概念 比较 含糊 

(可 能 只 是 理解 为 容器 控制 对 象 这 一 个 层面 ， 很 难 让 人 想到 谁 来 维护 对 象 关系 ) ， 所 以 2004 
年 大 师 级 人 物 Martin Fowler 又 给 出 了 一 个 新 的 名 字 :“ 依 赖 注 入 ”， 相 对 loC 而 言 ，“ 依 赖 注 
入 ”明确 描述 了 “被 注入 对 象 依赖 loC 容 器 配置 依赖 对 象 ”。 


注 : 如 果 想 要 更 加 深入 的 了 解 loC 和 DI， 请 参考 大 师 级 人 物 Martin Fowler 的 一 篇 经 典 文章 
《Inversion of Control Containers and the Dependency Injection pattern》， 原 文 地 址 : 
http://www.martinfowler.com/articles/injection.html 。 


转自 【http://sishuok.com/forum/blogPost/list/2427.html] 


【第 二 章 】loC 之 2.2 loC 容器 基本 原理 一 跟 我 
学 Spring3 


2.2.1 loC 容 器 的 概念 


loC 容 器 就 是 具有 依赖 注入 功能 的 容器 ，loC 容 器 负责 实例 化 、 定 位 、 配 置 应 用 程序 中 的 对 象 
及 建立 这 些 对 象 间 的 依赖 。 应 用 程序 无 需 直接 在 代码 中 new 相 关 的 对 象 ， 应 用 程序 由 IloC 容 器 
进行 组 装 。 在 Spring 中 BeanFactory 是 loC 容 器 的 实际 代表 者 。 


Spring loC 容 器 如 何 知道 哪些 是 它 管理 的 对 象 呢 ? 这 就 需要 配置 文件 ，Spring loC 容 器 通过 读 
Pe ， 通 过 元 数据 对 应 用 中 的 各 个 对 象 进行 实例 化 及 装配 。 一 般 使 用 
基于 xml 配 置 文件 进行 配置 元 数据 ， 而 且 Spring 与 配置 文件 完全 解 辜 的 ， 可 以 使 用 其 他 任何 可 
能 的 方式 进行 配置 元 数据 ， 比 如 注解 、 基 于 java 文 件 的 、 基 于 属性 文件 的 配置 都 可 以 。 


那 Spring loC 容 器 管理 的 对 象 叫 什么 呢 ? 


2.2.2 Bean 的 概念 


由 IloC 容 器 管理 的 那些 组 成 你 应 用 程序 的 对 象 我 们 就 叫 它 Bean ，Bean 就 是 由 Spring 容器 初始 
化 、 装 配 及 管理 的 对 象 ， 除 此 之 外 ，bean 就 与 应 用 程序 中 的 其 他 对 象 没 有 什么 区 别 了 。 那 loC 
怎样 确定 如 何 实例 化 Bean、 0 的 依赖 关系 以 及 管理 Bean 呢 ? 这 就 需要 配置 元 数 
据 ， 在 Spring 中 由 BeanDefinition 代 表 ， 后 边 会 详细 介绍 ， 配 置 元 数据 指定 如 何 实例 化 Bean、 
如 何 组 装 Bean 等 。 概 念 知 道 的 差不多 了 ， ee 


2.2.3 Hello World 
一 、 配 置 环 境 : 
| JDK 安 装 : 安装 最 新 的 JDK， 至 少 需要 Java 1.5 及 以 上 环境 ; 


| 开发 工具 : SpringSource Tool Suite， 简 称 STS， 有 是 个 基于 Eclipse 的 开发 环境 ， 用 以 构建 
Spring 应 用 ， 其 最 新 版 开始 支持 Spring 3.0 及 OSGi 开 发 工具 ， 但 由 于 其 太 庞 大 ， 很 多 功能 不 是 
我 们 所 必需 的 所 以 我 们 选择 Eclipse+ SpringSource Tool 插 件 进行 Spring 应 用 开发 ; 到 eclipse 

官网 下 载 最 新 的 Eclipse， 注 意 我 们 使 用 的 是 Eclipse IDE for Java EE Developers (eclipse- 
jee-helios-SR1) ; 


安装 插件 : 启动 Eclipse， 选 择 Help->lnstall New Software， 如 图 2-3 所 示 


2、 首 先 安装 SpringSource Tool Suite 插 件 依赖 ， 如 图 2-4: 
Name 为 : SpringSource Tool Suite Dependencies 


Location 为 : http://dist.springsource.com/release/TOOLS/composite/e3.6 


图 2-4 安装 
3、 安 装 SpringSource Tool Suite 插 件 ， 只 需 安 装 如 图 2-5 所 选中 的 就 可 以 : 
Name 为 : SpringSource Tool Suite 


Location 为 : http://dist.springsource.com/release/TOOLS/update/e3.6 


4、 安 装 完毕 ， 开 始 项 目 搭建 吧 。 
Spring 依赖 : 本 书 使 用 spring-framework-3.0.5.RELEASE 
spring-framework-3.0.5.RELEASE-with-docs.zip 表 示 此 压缩 包 带 有 文档 的 ; 


spring-framework-3.0.5.RELEASE-dependencies.zip 表 示 此 压缩 包 中 是 spring 的 依赖 jar 包 ， 
所 以 需要 什么 依赖 从 这 里 找 就 好 了 ; 


下 载 地 址 : http://www.springsource.org/download 

二 、 开 始 Spring Hello World 之 旅 

1、 准 备 需要 的 jar 包 

核心 jar 包 : 从 下 载 的 spring-framework-3.0.5.RELEASE-with-docs.zip 中 dist 目 录 查 找 如 下 jar 
包 


org.springframework.asm-3.0.5.RELEASE. jar 
org.springframework.core-3.0.5.RELEASE. jar 
org.springframework.beans-3.0.5.RELEASE.jar 
org.springframework.context-3.0.5.RELEASE.jar 


org.springframework.expression-3.0.5.RELEASE.jar 


依赖 的 jar 包 : 从 下 载 的 spring-framework-3.0.5.RELEASE-dependencies.zip 中 查找 如 下 依赖 
jar 包 


com.springsource.org.apache.10g94j-1.2.15.jar 
com.springsource.org.apache.commons.logging-1.1.1.jar 


com.springsource.org.apache.commons.collections-3.2.1.jar 


2、 创 建 标准 Java 工 程 : 


(1) 选择 “window” 一 > “Show View” 一 >“Package Explorer”， 使 用 包 结 构 视 图 ; 


图 2-5 包 结 构 视图 


(2) 创建 标准 Java 项 目 ， 选 择 “File” 一 >“New” 一 >“Other” ; 然后 在 弹出 来 的 对 话 框 中 选 
择 “Java Project" 创 建 标准 Java 项 目 ; 


图 2-6 创建 Java 项 目 


图 2-7 创建 Java 项 目 


图 2-8 创建 Java 项 目 


(3) 配置 项 目 依 赖 库 文 件 ， 右 击 项 目 选择 “Properties”; 然后 在 弹出 的 对 话 框 中 点 击 “Add 
JARS” 在 弹出 的 对 话 框 中 选择 "lib” 目 录 下 的 jar 包 ; 然后 再 点 击 “Add Library”， 然 后 在 弹出 的 对 
话 框 中 选择 “Junit*， 选 择 “Junit4”; 


图 2-9 配置 项 目 依赖 库 文件 


图 2-10 配置 项 目 依赖 库 文件 


图 2-11 配置 项 目 依赖 库 文件 


(4) 项 目 目录 结构 如 下 图 所 示 ， 其 中 src" 用 于 存放 java 文 件 ; ib” 用 于 存放 jar 文 
件 ; “resources" 用 于 存放 配置 文件 ; 


图 2-12 项 目 目录 结构 


3、 项 目 搭 建 好 了 ， 让 我 们 来 开发 接口 ， 此 处 我 们 只 需 实现 打印 “Hello Worldl*”， 所 以 我 们 定义 
一 个 “sayHello” 接 口 ， 代 码 如 下 : 


1. 
2. 
3. 
4. 


package cn.javass.spring.chapter2.helloworld; 
public interface HelloApi { 

public void sayHello(); 

} 


4、 接 口 开发 好 了 ， 让 我 们 来 通过 实现 接口 来 完成 打印 “Hello World1” 功 能 ; 
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package cn.javass.spring.chapter2.helloworld; 
public class Hellolmpl implements HelloApi { 
@Override 

public void sayHello() { 
System.out.println("Hello World!"); 


} 
} 


5、 接 口 和 实现 都 开发 好 了 ， 那 如 何 使 用 Spring loC 容 器 来 管理 它们 呢 ? 这 就 需要 配置 文件 ， 
让 loC 容 器 知道 要 管理 哪些 对 象 。 让 我 们 来 看 下 配置 文件 chapter2/helloworld.xml ( 放 到 
resources 目 录 下 ) 


1. 


9. 
10. 
11. 


own 


<?xml version="1.0" encoding="UTF-8"?> 

<beans 

xmins="http://www.springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmins:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation=" 

http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-3.0.xsd"&gt; 
<I-- id 表示 你 这 个 组 件 的 名 字 ，class 表 示 组 件 类 --> 

<bean id="hello" class="cn.javass.spring.chapter2.helloworld. HellolImpl"></bean> 
</beans> 


6、 现 在 万 一 具备 ， 那 如 何 获取 loC 容 器 并 完成 我 们 需要 的 功能 呢 ? 首先 应 该 实例 化 一 个 loC 容 
器 ， 然 后 从 容器 中 获取 需要 的 对 象 ， 然 后 调用 接口 完成 我 们 需要 的 功能 ， 代 码 示 例如 下 : 


oD 


package cn.javass.spring.chapter2.helloworld; 

import org.junit. Test; 

import org.springframework.context.ApplicationContext; 

import org.springframework.context.support.ClassPathXmlApplicationContext; 
public class HelloTest { 


6. @Test 
7. public void testHelloWorld() { 
8. //1、 读 取 配 置 文 件 实例 化 一 个 loC 容 器 
9. ApplicationContext context = new ClassPathXmlApplicationContext("helloworld.xml"); 
10. //2、 从 容器 中 获取 Bean， 注 意 此 处 完全 "面向 接口 编程 ， 而 不 是 面向 实现 ” 
11. HelloApi helloApi = context.getBean("hello", HelloApi.class); 
12. 1//3、 执 行业 务 逻 辑 
13. helloApi.sayHello(); 
14. } 
15. } 


7、 自 此 一 个 完整 的 Spring Hello World 已 完成 ， 是 不 是 很 简单 ， 让 我 们 深入 理解 下 容器 和 
Bean 吧 “。 


2.2.4 详解 loC 容 器 


容器 


在 Spring loc 容 器 的 代表 就 是 org.springframework.beans 包 中 的 BeanFactory 接 口 ， 
BeanFactory 接 口 提供 了 loC 容 器 最 基本 功能 ; 而 org.springframework.context 包 下 的 
ApplicationContext 接 口 扩展 了 BeanFactory， 还 提供 了 与 Spring AOP 集 成 、 国 际 化 处 理 、 事 
件 传 播 及 提供 不 同 层 次 的 context 实 现 (如 针对 web 应 用 的 WebApplicationContext)。 简 单 说 ， 
BeanFactory 提 供 了 loC 容 器 最 基本 功能 ， 而 ApplicationContext 则 增加 了 更 多 支持 企业 级 功 
能 支持 。ApplicationContext 完 全 继承 BeanFactory， 因 而 BeanFactory 所 具有 的 语义 也 适用 于 
ApplicationContext 。 


容器 实现 一 览 : 


。XmlBeanFactory : BeanFactory 实 现 ， 提 供 基本 的 loC 容 器 功能 ， 可 以 从 classpath 或 文件 
系统 等 获取 资源 ; 


(1) File file = new File("fileSystemConfig.xml"); 
Resource resource = new FileSystemResource(file ); 
BeanFactory beanFactory = new XmlBeanFactory(resource); 
(2) 
Resource resource = new ClassPathResource("classpath.xml"); 
BeanFactory beanFactory = new XmlBeanFactory(resource); 


。ClassPathXmlApplicationContext : ApplicationContext 实 现 ， 从 classpath 获 取 配 置 文 
件 ; 


BeanFactory beanFactory = new ClassPathXmlIApplicationContext("classpath.xml”); 


。FileSystemXmlApplicationContext : ApplicationContext 实 现 ， 从 文件 系统 获取 配置 文 
件 。 


BeanFactory beanFactory = new FileSystemxmlApplicationContext("fileSystemConfig.xml”); 
具体 代码 请 参考 cn.javass.spring.chapter2.InstantiatingContainerTest.java。 
ApplicationContext 接 口 获 取 Bean 方 法 简介 : 

。Object getBean(String name) 根据 名 称 返 回 一 个 Bean， 客 户 端 需要 自己 进行 类 型 转换 ; 


*。T getBean(String name, Class<T> requiredType) 根据 名 称 和 指定 的 类 型 返回 一 个 Bean， 客 
户 端 无 需 自己 进行 类 型 转换 ， 如 果 类 型 转换 失败 ， 容 器 抛 出 异常 ; 


。T getBean(Class<T> requiredType) 根据 指定 的 类 型 返回 一 个 Bean， 客 户 端 无 需 自 己 进 行 类 
型 转换 ， 如 果 没 有 或 有 多 于 一 个 Bean 存 在 容器 将 抛 出 异常 ; 


。Map<String, T> getBeansOfType(Class<T> type) 根据 指定 的 类 型 返回 一 个 键 值 为 名 字 和 值 
为 Bean 对 象 的 Map， 如 果 没 有 Bean 对 象 存在 则 返回 空 的 Map。 


让 我 们 来 看 下 IloC 容 器 到 底 是 如 何 工作 。 在 此 我 们 以 Xml 配置 方式 来 分 析 一 下 : 


一 、 准 备 配置 文件 : 就 像 前 边 Hello World 配 置 文件 一 样 ， 在 配置 文件 中 声明 Bean 定 义 也 就 是 
为 Bean 配 置 元 数据 。 


二 、 由 loC 容 器 进行 解析 元 数据 : loC 容 器 的 Bean Reader 读 取 并 解析 配置 文件 ， 根 据 定义 生 
成 BeanDefinition 配 置 元 数据 对 象 ，|loC 容 器 根据 BeanDefinition 进 行 实例 化 、 配 置 及 组 装 
Bean。 


三 、 实 例 化 loC 容 器 : 由 客户 端 实例 化 容器 ， 获 取 需 要 的 Bean 。 


整个 过 程 是 不 是 很 简单 ， 执 行 过 程 如 图 2-5， 其 实 loC 容 器 很 容易 使 用 ， 主 要 是 如 何 进行 Bean 
定义 。 下 一 章 我 们 详细 介绍 定义 Bean 。 


图 2-5 Spring loc 容 器 


2.2.5 小 结 


除了 测试 程序 的 代码 外 ， 也 就 是 程序 入 口 ， 所 有 代码 都 没有 出 现 Spring 任 何 组 件 ， 而 且 所 有 我 
们 写 的 代码 没有 实现 框架 拥有 的 接口 ， 因 而 能 非常 容易 的 替换 掉 Spring， 是 不 是 非 入 侵 。 
客户 端 代码 完全 面向 接口 编程 ， 无 需 知 道 实现 类 ， 可 以 通过 修改 配置 文件 来 更 换 接 口 实现 ， 
客户 端 代 码 不 需要 任何 修改 。 是 不 是 低 耦 合 。 

如 果 在 开发 初期 没有 引 正 的 实现 ， 我 们 可 以 模拟 一 个 实现 来 测试 ， 不 耦合 代码 ， 是 不 是 很 方 
便 测 试 。 


跟 我 学 Spring 系列 


Bean 之 间 几 乎 没有 依赖 关系 ， 是 不 是 很 容易 重用 。 


转自 【http://sishuok.com/forum/blogPost/list/2428.html] 


【第 二 章 】 IoC 之 2.2 loC 容器 基本 原理 一 一 跟 我 学 Spring3 


16 


【第 二 章 】 loC 之 2.3 loC 的 配置 使 用 一 一 跟 我 学 
Spring3 


2.3.1 XML 配置 的 结构 


一 般配 置 文件 结构 如 下 : 


. <beans> 
. <import resource= resource1.Xxml/> 


. <bean id="bean1 ”class=”></bean> 


. <bean id="bean2"class=”></bean> 


. <alias alias="bean3" name="bean2"/> 


1 

2 

3 

4 

5. <bean name="bean2”class=”></bean> 
6 

7. <import resource= resource2.xml"/> 

8 


. </beans> 
1、<bean> 标 签 主要 用 来 进行 Bean 定 义 ; 
2、alias 用 于 定义 Bean 别 名 的 ; 


3、import 用 于 导入 其 他 配置 文件 的 Bean 定 义 ， 这 是 为 了 加 载 多 个 配置 文件 ， 当 然 也 可 以 把 这 
些 配 置 文件 构造 为 一 个 数组 (new String[] {*config1.xml”, config2.xml}) 传 给 
ApplicationContext 实 现 进行 加 载 多 个 配置 文件 ， 那 一 个 更 适合 由 用 户 决 定 ; 这 两 种 方式 都 是 
通过 调用 Bean Definition Reader 读 取 Bean 定 义 ， 内 部 实现 没有 任何 区 别 。<import> 标 签 可 以 
放 在 <beans> 下 的 任何 位 置 ， 没 有 顺序 关系 。 


2.3.2 Bean 的 配置 


Spring loC 容 器 目的 就 是 管理 Bean， 这 些 Bean 将 根据 配置 文件 中 的 Bean 定 义 进行 创建 ， 而 
Bean 定 义 在 容器 内 部 由 BeanDefinition 对 象 表 示 ， 该 定义 主要 和 包含 以 下 信息 : 


e 全 限定 类 名 (FQN) : 用 于 定义 Bean 的 实现 类 ; 


eBean 行 为 定义 : 这 些 定 义 了 Bean 在 容器 中 的 行为 ; 包括 作用 域 ( 单 例 、 原 型 创建 ) 、 是 
惰性 初始 化 及 生命 周期 等 ; 


ba 


eBean 创 建 方式 定义 : 说 明 是 通过 构造 器 还 是 工厂 方法 创建 Bean ; 


eBean 之 间 关 系 定义 : 即 对 其 他 bean 的 引用 ， 也 就 是 依赖 关系 定义 ， 这 些 引 用 bean 也 可 以 称 
之 为 同事 bean 或 依赖 bean， 也 就 是 依赖 注入 。 


Bean 定 义 只 有 “全 限定 类 名 ”在 当 使 用 构造 器 或 静态 工厂 方法 进行 实例 化 bean 时 是 必须 的 ， 其 
他 都 是 可 选 的 定义 。 难 道 Spring 只 能 通过 配置 方式 来 创建 Bean 吗 ? 回答 当然 不 是 ， 某 些 
SingletonBeanRegistry 接 口 实现 类 实现 也 允许 将 那些 非 BeanFactory 创 建 的 、 已 有 的 用 户 对 象 
注册 到 容器 中 ， 这 些 对 象 必须 是 共享 的 ， 比 如 使 用 DefaultListableBeanFactory 的 
registerSingleton() 方法 。 不 过 建议 采用 元 数据 定义 。 


2.3.3 Bean 的 命名 


每 个 Bean 可 以 有 一 个 或 多 个 id (或 称 之 为 标识 符 或 名 字 ) ， 在 这 里 我 们 把 第 一 个 id 称 为 “标识 
符 ”， 其 余 id 叫做 4 别名 ”; 这 些 id 在 loC 容 器 中 必须 唯一 。 如 何 为 Bean 指 定 id 呢 ， 有 以 下 几 种 方 
式 ; 


一 、 不 指定 id， 只 配置 必须 的 全 限定 类 名 ， 由 loC 容 器 为 其 生成 一 个 标识 ， 客 户 端 必 须 通 过 接 
口 “TgetBean(Class<T> redquiredType)” 获 取 Bean ; 


1. <bean class=” cn.javass.spring.chapter2.helloworld.Hellolmpl”/> (1) 
测试 代码 片段 如 下 : 


@Test 

public void test1() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/namingbean1.xml"); 
// 根 据 类 型 获取 bean 

HelloApi helloApi = beanFactory.getBean(HelloApi.class); 
helloApi.sayHello(); 

} 


二 、 指 定 id， 必 须 在 loc 容 器 中 唯一 ; 
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1. <bean id=” bean” class=”cn.javass.spring.chapter2.helloworld.HellolImpl/> (2) 
测试 代码 片段 如 下 : 


@Test 

public void test2() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/namingbean2.xml"); 
// 根 据 id 获 取 bean 

HelloApi bean = beanFactory.getBean("bean", HelloApi.class); 
bean.sayHello(); 


; 


三 、 指 定 name， 这 样 hame 就 是 “标识 符 ”， 必 须 在 loc 容 器 中 唯一 ; 
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1. <bean name=” bean” class=” cn.javass.spring.chapter2.helloworld.Hellolmpl”/> (3) 
测试 代码 片段 如 下 : 


1. @Test 

2. public void test3() { 

3. BeanFactory beanFactory = 

4. new ClassPathXmlApplicationContext("chapter2/namingbean3.xml"); 
5. // 根 据 name 获 取 bean 

6. HelloApi bean = beanFactory.getBean("bean", HelloApi.class); 

7. bean.sayHello(); 

8. } 


四 、 指 定 d 和 name ， id 就 是 标识 符 ， 而 name 就 是 别名 ， 必 须 在 loc 容 器 中 唯一 ; 


1. <bean id="bean1"name="alias1” 

2. class=” cn.javass.spring.chapter2.helloworld.Hellolmpl”/> 

3.， <!-- 如 果 id 和 name 一 样 ，loC 容 器 能 检测 到 ， 并 消除 冲突 --> 

4. <bean id="bean3" name="bean3" 
class="cn.javass.spring.chapter2.helloworld.HellolImpl"/> (4) 


测试 代码 片段 如 下 : 


@Test 

public void test4() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/namingbean4.xml"); 
// 根 据 id 获 取 bean 

HelloApi bean1 = beanFactory.getBean("bean1", HelloApi.class); 
bean1.sayHello(); 

// 根 据 别 名 获取 bean 

HelloApi bean2 = beanFactory.getBean("alias1", HelloApi.class); 
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bean2.sayHello(); 
. // 根 据 id 获 取 bean 
HelloApi bean3 = beanFactory.getBean("bean3", HelloApi.class); 


= 
wD 


bean3.sayHello(); 


~、 


String[] bean3Alias = beanFactory.getAliases("bean3"); 

// 因 此 别名 不 能 和 id 一 样 ， 如 果 一 样 则 由 loC 容 器 负责 消除 冲突 
Assert.assertEquals(0, bean3Alias.length); 

17. } 


_、 ~ 
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五 、 指 定 多 个 name， 多 个 name 用 “，”、“;”、“” 分 割 ， 第 一 个 被 用 作 标 识 符 ， 其 他 的 
(alias1、alias2、alias3) 是 别名 ， 所 有 标识 符 也 必须 在 loc 容 器 中 唯一 ; 


1. <bean name=” bean1;alias11,alias12;alias13 alias14” 
2. class=” cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
3，<!-- 当 指 定 id 时 ，name 指 定 的 标识 符 全 部 为 别名 --> 
4. <bean id="bean2" name="alias21;alias22" 
5. class="cn.javass.spring.chapter2.helloworld.HellolImpl"/> (5) 
测试 代码 片段 如 下 : 
1. @Test 
2. public void test5() { 
3. BeanFactory beanFactory = 
4. new ClassPathXmlApplicationContext("chapter2/namingbean5.xml"); 
5. //1 根 据 id 获 取 bean 
6. HelloApi bean1 = beanFactory.getBean("bean1", HelloApi.class); 
7. bean1.sayHello(); 
8. /2 根据 别名 获取 bean 
9. HelloApi alias11 = beanFactory.getBean("alias11", HelloApi.class); 
10. alias11.sayHello(); 
11. /3 验证 确实 是 四 个 别名 
12. String[] bean1Alias = beanFactory.getAliases("bean1"); 
13. System.out.printIn("=======namingbean5.xml bean1 别名 ========"); 
14. for(String alias : bean1Alias) { 
15. System.out.printin(alias); 
16. } 
17. Assert.assertEquals(4, bean1Alias.length); 
18. // 根 据 id 获 取 bean 
19. HelloApi bean2 = beanFactory.getBean("bean2", HelloApi.class); 
20. bean2.sayHello(); 
21. /2 根据 别名 获取 bean 
22. HelloApi alias21 = beanFactory.getBean("alias21", HelloApi.class); 
23. alias21.sayHello(); 
24. 1/ 验证 确实 是 两 个 别名 
25. String[] bean2Alias = beanFactory.getAliases("bean2"); 
26. System.out.println("=======namingbean5.xml bean2 别名 ========"); 
27. for(String alias : bean2Alias) { 
28. System.out.printin(alias); 
29. } 
30. Assert.assertEquals(2, bean2Alias.length); 
31. } 


六 、 使 用 <alias> 标 签 指定 别 名 ， 别 名 也 必须 在 loC 容 器 中 唯一 


1. <bean name="bean" class="cn.javass.spring.chapter2.helloworld.HellolImpl"/> 
2. <alias alias="alias1" name="bean"/> 
3. <alias alias="alias2" name="bean"/> (6) 


测试 代码 片段 如 下 : 


@Test 

public void test6() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/namingbean6.xml"); 
// 根 据 id 获 取 bean 

HelloApi bean = beanFactory.getBean("bean", HelloApi.class); 
bean.sayHello(); 

// 根 据 别 名 获取 bean 

HelloApi alias1 = beanFactory.getBean("alias1", HelloApi.class); 
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10. alias1.sayHello(); 

11. HelloApi alias2 = beanFactory.getBean("alias2", HelloApi.class); 

12. alias2.sayHello(); 

13. String[] beanAlias = beanFactory.getAliases("bean"); 

14. System.out.printIn("=======namingbean6.xml bean 别名 ========"); 
15. for(String alias : beanAlias) { 

16. System.out.printin(alias); 

17. } 

18. System.out.printIn("=======namingbean6.xml bean 别名 ========"); 
19. Assert.assertEquals(2, beanAlias.length); 

20. } 


以 上 测试 代码 在 cn.javass.spring.chapter2.NamingBeanTest.java 文 件 中 。 


从 定义 来 看 ，name 或 id 如 果 指 定 它 们 中 的 一 个 时 都 作为 “标识 符 "， 那 为 什么 还 要 有 id 和 name 
同时 存在 呢 ? 这 是 因为 当 使 用 基于 XML 的 配置 元 数据 时 ， 在 XML 中 id 是 一 个 监 正 的 XML id 属 
性 ， 因 此 当 其 他 的 定义 来 引用 这 个 id 时 就 体现 出 id 的 好 处 了 ， 可 以 利用 XML 解 析 器 来 验证 引用 
的 这 个 dd 是否 存在 ， 从 而 更 旱 的 发 现 是 否 引 用 了 一 个 不 存在 的 bean， 而 使 用 name， 则 可 能 
在 真 正 使 用 bean 时 才能 发 现 引 用 一 个 不 存在 的 bean。 


eBean 命 名 约定 : Bean 的 命名 遵循 XML 命名 规范 ， 但 最 好 符合 Java 命 名 规范 ， 由 "字母 、 数 
字 、 下 划 线 组 成 <， 而 且 应 该 养 成 一 个 良好 的 命名 习惯 ， 比 如 采用 "驼峰 式 ”， 即 第 一 个 单词 首 
字母 开始 ， 从 第 二 个 单词 开始 首 字母 大 写 开 始 ， 这 样 可 以 增加 可 读 性 。 


2.3.4 实例 化 Bean 


Spring loC 容 器 如 何 实例 化 Bean 呢 ? 传统 应 用 程序 可 以 通过 new 和 反射 方式 进行 实例 化 
Bean。 而 Spring loC 容 器 则 需要 根据 Bean 定 义 里 的 配置 元 数据 使 用 反射 机 制 来 创建 Bean。 在 
Spring loC 容 器 中 根据 Bean 定 义 创建 Bean 主 要 有 以 下 几 种 方式 : 


一 、 使 用 构造 器 实例 化 Bean : 这 是 最 简单 的 方式 ，Spring loC 容 器 即 能 使 用 默认 空 构造 器 也 
能 使 用 有 参数 构造 器 两 种 方式 创建 Bean， 如 以 下 方式 指定 要 创 ee : 


使 用 空 构 造 器 进行 定义 ， 使 用 此 种 方式 ，class 属 性 指定 的 类 必须 有 空 构造 器 
1. <bean name="bean1" class="cn.javass.spring.chapter2.Hellolmpl2"/> 


使 用 有 参数 构造 器 进行 定义 ， 使 用 此 中 方式 ， 可 以 使 用 < constructor-arg > 标签 指定 构造 器 参 
数值 ， 其 Re ， Value 表示 常量 值 ， 也 可 以 指定 引用 ， 指 定 引 用 使 用 ref 来 引用 另 
一 个 Bean 定 义 ， 后 边 会 详细 介绍 : 


<bean name="bean2" class="cn.javass.spring.chapter2.Hellolmpl2"> 
<I-- 指定 构造 器 参数 --> 

<constructor-arg index="0" value="Hello Spring!"/> 

</bean> 
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知道 如 何 配置 了 ， 让 我 们 做 个 例子 的 例子 来 实践 一 下 吧 : 
(1) 准备 Bean class(Hellolmpl2.java)， 该 类 有 一 个 空 构造 器 和 一 个 有 参 构 造 器 : 


package cn.javass.spring.chapter2; 
public class Hellolmpl2 implements HelloApi { 
private String message; 

public Hellolmpl2() { 

this.message = "Hello World!"; 

} 

Public HellolImpl2(String message) { 
this.message = message; 

} 

@Override 

. public void sayHello() { 
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System.out.println(message); 


} 
14. } 
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(2) 在 配置 文件 (resources/chapter2/instantiatingBean.xml) 配 置 Bean 定 义 ， 如 下 所 示 : 


1. <!-- 使 用 默认 构造 参数 --> 
2. <bean name="bean1" class="cn.javass.spring.chapter2.Hellolmpl2"/> 
3，<I-- 使 用 有 参数 构造 参数 --> 


4. <bean name="bean2" class="cn.javass.spring.chapter2.Hellolmpl2"> 


5，<I-- 指定 构造 器 参数 --> 
6. <constructor-arg index="0" value="Hello Spring! /> 
7. </bean> 


(3) 配置 完了 ， 让 我 们 写 段 测试 代码 (InstantiatingContainerTest) 来 看 下 是 否 工 作 吧 : 


@Test 

public void testInstantiatingBeanByConstructor() { 

// 使 用 构造 器 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/instantiatingBean.xml"); 
HelloApi bean1 = beanFactory.getBean("bean1", HelloApi.class); 
bean1.sayHello(); 

HelloApi bean2 = beanFactory.getBean("bean2", HelloApi.class); 
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bean2.sayHello(); 
} 


二 、 使 用 静态 工厂 方式 实例 化 Bean， 使 用 这 种 方式 除了 指定 必须 的 class 属 性 ， 还 要 指定 
factory-method 属 性 来 指定 实例 化 Bean 的 方法 ， 而 且 使 用 静态 工厂 方法 也 允许 指定 方法 参 
数 ，spring loC 容 器 将 调用 此 属性 指定 的 方法 来 获取 Bean， 配 置 如 下 所 示 : 


~、 
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(1) 先 来 看 看 静态 工厂 类 代码 吧 HelloApiStaticFactory : 


1. public class HelloApiStaticFactory { 

2. // 工 厂 方法 

3. public static HelloApi newlnstance(String message) { 
4. // 返 回 需要 的 Bean 实 例 

5. return new HellolImpl2(message); 

6. } 

7. } 


(2) 静态 工厂 写 完 了 ， 让 我 们 在 配置 文件 (resources/chapter2/instantiatingBean.xml) 配 置 
Bean 定 义 : 
1. <!-- 使 用 静态 工厂 方法 --> 
2. <bean id="bean3" class="cn.javass.spring.chapter2.HelloApiStaticFactory" factory- 
method="newlnstance'"> 
3. <constructor-arg index="0" value="Hello Spring! /> 
4. </bean> 


(3) 配置 完了 ， 写 段 测试 代 码 来 测试 一 下 吧 ，|InstantiatingBeanTest : 


1. @Test 
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public void testlnstantiatingBeanBysStaticFactory() { 

// 使 用 静态 工厂 方法 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chaper2/instantiatingBean.xml"); 
HelloApi bean3 = beanFactory.getBean("bean3", HelloApi.class); 
bean3.sayHello(); 


} 


、 使 用 实例 工厂 方法 实例 化 Bean， 使 用 这 种 方式 不 能 指定 class 属 性 ， 此 时 必须 使 用 
factory-bean 属 性 来 指定 工厂 Bean，factory-method 属 性 指定 实例 化 Bean 的 方法 ， 而 且 使 用 实 


例 工 厂 方法 允许 指定 方法 参数 ， 方 式 和 使 用 构造 器 方式 一 样 ， 配 置 如 下 : 


(1) 实例 工厂 类 代码 (HelloApilnstanceFactory.java) 如 下 : 


OPoDPD= 


package cn.javass.spring.chapter2 ; 

public class HelloApilnstanceFactory { 

public HelloApi newlnstance(String message) { 
return new HellolImpl2(message); 

} 

} 


(2) 让 我 们 在 配置 文件 (resources/chapter2/instantiatingBean.xml) 配 置 Bean 定 义 : 
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<! 一 1、 定 义 实 例 工 厂 Bean --> 

<bean id="beanlnstanceFactory” 
class="cn.javass.spring.chapter2.HelloApilnstanceFactory"/> 

<! 一 2、 使 用 实例 工厂 Bean 创 建 Bean --> 

<bean id="bean4 

factory-bean="beaninstanceFactory" 
factory-method="newlnstance"> 

<constructor-arg index="0" value="Hello Spring!"></constructor-arg> 
</bean> 


(3) 测试 代码 InstantiatingBeanTest : 
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@Test 

public void testlnstantiatingBeanBylnstanceFactory(){ 

// 使 用 实例 工厂 方法 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter2/instantiatingBean.xml"); 
HelloApi bean4 = beanFactory.getBean("bean4", HelloApi.class); 
bean4.sayHello(); 


} 


通过 以 上 例子 我 们 已 经 基本 掌握 了 如 何 实例 化 Bean 了 ， 大 家 是 否 注 意 到 ? 这 三 种 方式 只 是 配 
置 不 一 样 ， 从 获取 方式 看 完全 一 样 ， 没 有 任何 不 同 。 这 也 是 Spring loC 的 魅力 ，Spring loC 帮 
你 创建 Bean， 我 们 只 管 使 用 就 可 以 了 ， 是 不 是 很 简单 。 


2.3.5 小 结 

到 此 我 们 已 经 讲 完了 Spring loC 基 础 部 分 ， 包 括 IloC 容 器 概念 ， 如 何 实例 化 容器 ，Bean 配 置 、 
命名 及 实例 化 ，Bean 获 取 等 等 。 不 知 大 家 是 否 注意 到 到 目前 为 止 ， 我 们 只 能 通过 简单 的 实例 
化 Bean， 没 有 涉及 Bean 之 问 关系 。 接 下 来 一 章 让 我 们 进入 配置 Bean 之 问 关系 章节 ， 也 就 是 
依赖 注入 。 


【第 三 章 】DI 之 3.1 DI 的 配置 使 用 一 一 跟 我 学 
spring3 


3.1.1 依赖 和 依赖 注入 

传统 应 用 程序 设计 中 所 说 的 依赖 一 般 指 "类 之 间 的 关系 "”， 那 先 让 我 们 复习 一 下 类 之 间 的 关系 : 
泛 化 : 表示 类 与 类 之 间 的 继承 关系 、 接 口 与 接口 之 间 的 继承 关系 ; 

实现 : 表示 类 对 接口 的 实现 ; 


依赖 : 当 类 与 类 之 间 有 使 用 关系 时 就 属于 依赖 关系 ， 不 同 于 关联 关系 ， 依 赖 不 具有 *“ 拥 有关 
系 "， 而 是 一 种 "相识 关系 "， 只 在 某 个 特定 地 方 (比如 菜 个 方法 体内 ) 才 有 关系 。 


关联 : 表示 类 与 类 或 类 与 接口 之 间 的 依赖 关系 ， 表 现 为 “拥有 关系 ”; 具体 到 代码 可 以 用 实例 变 
量 来 表示 ; 

聚合 : 属于 是 关联 的 特殊 情况 ， 体 现 部 分 -整体 关系 ， 是 一 种 弱 拥 有 关系 ; 整体 和 部 分 可 以 有 
不 一 样 的 生命 周期 ; 是 一 种 弱 关联 ; 


组 合 : 属于 是 关联 的 特殊 情况 ， 也 体现 了 体现 部 分 -整体 关系 ， 是 一 种 强 “ 拥 有 关系 ”; 整体 与 
部 分 有 相同 的 生命 周期 ， 是 一 种 强 关联 ; 


Spring loC 容 器 的 依赖 有 两 层 含义 : Bean 依 赖 容 器 和 容器 注入 Bean 的 依赖 资源 : 


Bean 依 赖 容器 : 也 就 是 说 Bean 要 依赖 于 容器 ， 这 里 的 依赖 是 指 容器 负责 创建 Bean 并 管理 
Bean 的 证 旬 周 期 ， 正 是 由 于 由 容器 来 控制 We ， 也 就 是 控制 权 被 反 转 了 ， 这 
也 正 是 loC 名 字 的 由 来 ， 此 处 的 有 依赖 是 指 Bean 和 容器 之 间 的 依赖 关系 。 


人 Bean 资源 : 容器 负责 注入 Bean 的 依赖 ， 依赖 资源 可 以 是 Bean、 人 外 部 文 
ee 常量 数据 等 ， en 对 象 ， 并 且 由 容器 负责 组 装 Bean 之 间 的 依赖 关系 ， 此 处 
的 依赖 是 指 Bean 之 间 的 依赖 关系 ， 可 以 认为 是 传统 类 与 人 的 “关联 ”、“ 聚 合 ”、“ 组合 ” 关 


为 什么 要 应 用 依赖 注入 ， 应 用 依赖 注入 能 给 我 们 带 来 哪些 好 处 呢 ? 


动态 蔡 换 Bean 依 赖 对 象 ， 程 序 更 灵活 : 替换 Bean 依 赖 对 象 ， 无 需 修改 源 文件 : 应 用 依赖 注入 
后 ， 由 于 可 以 采用 配置 文件 方式 实现 ， 从 而 能 随时 动态 的 替换 Bean 的 依赖 对 象 ， 无 需 修 改 
java 源 文件 ; 

更 好 实践 面向 接口 编程 ， 代 码 更 清晰 : 在 Bean 中 只 需 指 定 依赖 对 象 的 接口 ， 接 口 定 义 依 赖 对 
象 完 成 的 功能 ， 通 过 容器 注入 依赖 实现 ; 


更 好 实践 优先 使 用 对 象 组 合 ， 而 不 是 类 继承 : 因为 loC 容 器 采用 注入 依赖 ， 也 就 是 组 合 对 象 ， 
从 而 更 好 的 实践 对 象 组 合 。 


e。 采用 对 象 组 合 ，Bean 的 功能 可 能 由 几 个 依赖 Bean 的 功能 组 合 而 成 ， 其 Bean 本 身 可 能 只 
提供 少许 功能 或 根本 无 任何 功能 ， 全 部 委托 给 依赖 Bean， 对 象 组 合 具有 动态 性 ， 能 更 方 
便 的 替换 掉 依 赖 Bean， 从 而 改变 Bean 功 能 ; 

e 而 如 果 采 用 类 继承 ，Bean 没 有 依赖 Bean， 而 是 采用 继承 方式 添加 新 功能 ，， 而 且 功 能 是 
在 编译 时 就 确定 了 ， 不 具有 动态 性 ， 而 且 采 用 类 继承 导致 Bean 与 子 Bean 之 间 高 度 耦 合 ， 
难以 复 用 。 


增加 Bean 可 复 用 性 : 依赖 于 对 象 组 合 ，Bean 更 可 复 用 且 复 用 更 简单 


ee 夺 合 : 由 于 我 们 完全 采用 面向 接口 编程 ， 在 代码 中 没有 直接 引用 Bean 依 赖 实 
ee ， 而 且 不 会 出 现 显示 的 创建 依赖 对 象 代 码 ， 而 且 这 些 依赖 是 由 容器 来 注 
入 ， 很 容易 替换 依赖 实现 类 ， 从 而 降低 Bean 与 依赖 之 间 耦 合 ; 


代码 结构 更 清晰 : 要 应 用 依赖 注入 ， 代 码 结 构 要 按照 规约 方式 进行 书写 ， 从 而 更 好 的 应 用 一 
些 最 佳 实践 ， 因 此 代码 结构 更 清晰 。 


从 以 上 我 们 可 以 看 出 ， 其 实 依赖 注入 只 是 一 种 装配 对 象 的 手段 ， 设 计 的 类 结构 才 是 基础 ， 如 
果 设 计 的 类 结构 不 支持 依赖 注入 ，Spring loC 容 器 也 注入 不 了 任何 东西 ， 从 而 从 根本 上 说 “如 
何 设计 好 类 结构 才 是 关键 ， 依 赖 注 入 只 是 一 种 装配 对 象 手段 ” 。 


前 边 loC 一 章 我 们 已 经 了 解 了 Bean 依 赖 容器 ， 那 容器 如 何 注 入 Bean 的 依赖 资源 ，Spring loC 
容器 注入 依赖 资源 主要 有 以 下 两 种 基本 实现 方式 : 


构造 器 注入 : 就 是 容器 实例 化 Bean 时 注入 那些 依赖 ， 通 过 在 在 Bean 定 义 中 指定 构造 器 参数 进 
行 注入 依赖 ， 包 括 实例 工厂 方法 参数 注入 依赖 ， 但 静态 工厂 方法 参数 不 允许 注入 依赖 ; 


setter 注 入 : 通过 setter 方 法 进行 注入 依赖 ; 
方法 注入 : 能 通过 配置 方式 替换 掉 Bean 方 法 ， 也 就 是 通过 配置 改变 Bean 方 法 功能 。 


我 们 已 经 知道 注入 实现 方式 了 ， 接 下 来 让 我 们 来 看 看 具体 配置 吧 。 


3.1.2 构造 器 注入 


使 用 构造 器 注入 通过 配置 构造 器 参数 实现 ， 构 造 器 参数 就 是 依赖 。 除 了 构造 器 方式 ， 还 有 静 
态 工厂 、 实 例 工厂 方法 可 以 进行 构造 器 注入 。 如 图 3-1 所 示 : 


通过 容器 构造 器 依赖 注入 实例 化 传统 实例 化 方式 
<bean class="...Helloltmbl3" > 1、 实 例 化 |Helloahi ahl = new HalloImpl 3t 





<constructor -atg index="0" Yalue="Helolo/> 2、\ 设置 参半 "Hellol 





<constructor -arg index="1" value="1"/> 设置 参 类 着 





图 3-1 实例 化 


构造 器 注入 可 以 根据 参数 索引 注入 、 参 数 类 型 注入 或 Spring3 支 持 的 参数 名 注入 ， 但 参数 名 注 
入 是 有 限制 的 ， 需 要 使 用 在 编译 程序 时 打开 调试 模式 ( 即 在 编译 时 使 用 javac -g:vars" 在 class 
文件 中 生成 变量 调试 信息 ， 默 认 是 不 包含 变量 调试 信息 的 ， 从 而 能 获取 参数 名 字 ， 否 则 获取 
不 到 参数 名 字 ) 或 在 构造 器 上 使 用 

@ConstructorProperties (java.beans.ConstructorProperties ) 注解 来 指定 参数 名 。 


首先 让 我 们 准备 测试 构造 器 类 Hellolmpl3java， 该 类 只 有 一 个 包含 两 个 参数 的 构造 器 : 


1. package cn.javass.spring.chapter3.helloworld; 
2. public class Hellolmpl3 implements HelloApi { 
3. private String message; 
4. private int index; 
5. //@java.beans.ConstructorProperties({"message", "index"}) 
6. public Hellolmpl3(String message, int index) { 
7. this.message = message; 
8. this.index = index; 
9. } 
10. @Override 
11. public void sayHello() { 
12. System.out.println(index + 
13. } 
14. } 


+ message); 


一 、 根 据 参 数 索引 注入 ， 使 用 标签 “<constructor-arg index="1" value="1"/>” 来 指定 注入 的 依 
赖 ， 其 中 “index" 表 示 索 引 ， 从 0 开始 ， 即 第 一 个 参数 索引 为 0，“value" 来 指定 注入 的 常量 值 ， 
配置 方式 如 下 : 


娱 


参数 索引 ， 从 0 开始 数值 


<constructor -arg index="0" value="Hello Worldl"/> 





A 


二 、 根 据 参 数 类 型 进行 注入 ， 使 用 标签 "<constructor-arg type="java.lang.String" value="Hello 
World!l"/>” 来 指定 注入 的 依赖 ， 其 中 “type” 表 示 需 要 匹配 的 参数 类 型 ， 可 以 是 基本 类 型 也 可 以 
是 其 他 类 型 ， 如 “in*、“java.lang.String”，“value” 来 指定 注入 的 常量 值 ， 配置 方式 如 下 : 


指定 类 型 ， 除 基本 类 型 
外 ， 必 须 全 限定 类 
如 java lang .String, int 


<constructor -arg type="javalang String" value="Hello World 岂 六 





三 、 根 据 参 数 名 进行 注入 ， 使 用 标签 “<constructor-arg name="message" value="Hello 
World!l"/>” 来 指定 注入 的 依赖 ， 其 中 “name” 表 示 需 要 匹配 的 参数 名 字 ，“Vvalue” 来 指定 注入 的 常 
量 值 ， 配 置 方式 如 下 : 


指定 参数 名 字 参数 值 


pm 


<constructor -are nmame="imessage"” value="Hello World!"/> 





四 、 让 我 们 来 用 具体 的 例子 来 看 一 下 构造 器 注入 怎么 使 用 吧 。 
(1) 首先 准备 Bean 类 ， 在 此 我 们 就 使 用 “HellolImpl3” 这 个 类 。 


(2) 有 了 Bean 类 ， 接 下 来 要 进行 Bean 定 义 配 置 ， 我 们 需要 配置 三 个 Bean 来 完成 上 述 三 种 依 
赖 注入 测试 ， 其 中 Bean ”bylndex" 是 通过 索引 注入 依赖 ; Bean "byType” 是 根据 类 型 进行 注入 
依赖 ; Bean "byName” 是 根据 参数 名 字 进 行 注 入 依赖 ， 具体 配置 文件 (resources/chapter3/ 
constructorDependencylnject.xml) 如 下 : 


1.， <!-- 通过 构造 器 参数 索引 方式 依赖 注入 --> 
2. <bean id="bylndex" class="cn.javass.spring.chapter3.Hellolmpl3"> 
3. <constructor-arg index="0" value="Hello World!"/> 
4. <constructor-arg index="1" value="1"/> 
5. </bean> 
6. <!-- 通过 构造 器 参数 类 型 方式 依赖 注入 --> 
7. <bean id="byType" class="cn.javass.spring.chapter3.Hellolmpl3"> 
8. <constructor-arg type="java.lang.String" value="Hello World!"/> 
9. <constructor-arg type="int" value="2"/> 
10. </bean> 
11.，<!-- 通过 构造 器 参数 名 称 方式 依赖 注入 --> 
12. <bean id="byName" class="cn.javass.spring.chapter3.Hellolmpl3"> 
13. <constructor-arg name="message" value="Hello World!"/> 
14. <constructor-arg name="index" value="3"/> 
15. </bean> 


(3) 配置 完毕 后 ， 在 测试 之 前 ， 因 为 我 们 使 用 了 通过 构造 器 参数 名 字 注 入 方式 ， 请 确保 编译 
时 class 文 件 包含 “ 变 量 信 息 "， 具 体 查看 编译 时 是 否 包含 “变量 调试 信息 ”请 右 击 项 目 ， 在 弹出 的 
对 话 框 选择 属性 ; 然后 在 弹出 的 对 话 框 选择 “Java Compiler" 条 目 ， 在 “Class 文件 生成 " 框 中 选 
择 “ 添 加 变量 信息 到 Class 文 件 (调试 器 使 用 ) ”， 具体 如 图 3-2 : 
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图 3-2 编译 时 打开 添加 变量 信息 选项 " 


(4) 接 下 来 让 我 们 测试 一 下 配置 是 否 工 作 ， 具 体 测试 代码 (cn.javass.spring.chapter3. 
DependencylnjectTest) 如 下 : 


1. @Test 
2. public void testConstructorDependencylnjectTest() { 


Fed 


BeanFactory beanFactory = new 
ClassPathXmlApplicationContext("chapter3/constructorDependencylnject.xml"); 
4. 1/ 获 取 根 据 参 数 索 引 依 赖 注入 的 Bean 
5. HelloApi bylndex = beanFactory.getBean("bylndex", HelloApi.class); 
6. bylndex.sayHello(); 
7. /获取 根据 参数 类 型 依赖 注入 的 Bean 
8. HelloApi byType = beanFactory.getBean("byType", HelloApi.class); 
9. byType.sayHello(); 
10. 1// 获 取 根 据 参 数 名 字 依 赖 注入 的 Bean 
11. HelloApi byName = beanFactory.getBean("byName", HelloApi.class); 
12. byName.sayHello(); 
13. } 


通过 以 上 测试 我 们 已 经 会 基本 的 构造 器 注入 配置 了 ， 在 测试 通过 参数 名 字 注 入 时 ， 除 了 可 以 
使 用 以 上 方式 ， 还 可 以 通过 在 构造 器 上 添加 @java.beans.ConstructorProperties({"message", 
"index"}) 注 解 来 指定 参数 名 字 ， 在 HellolImpl3 构 造 器 上 把 注释 掉 的 “ConstructorProperties” 打 开 
就 可 以 了 ， 这 个 就 留 给 大 家 做 练习 ， 自 己 配 置 然 后 测试 一 下 。 


五 、 大 家 已 经 会 了 构造 器 注入 ， 那 让 我 们 再 看 一 下 静态 工厂 方法 注入 和 实例 工厂 注入 吧 ， 其 
实 它 们 注入 配置 是 完全 一 样 ， 在 此 我 们 只 示范 一 下 静态 工厂 注入 方式 和 实例 工厂 方式 配置 ， 
测试 就 留 给 大 家 自己 练习 : 


(1) 静态 工厂 类 


// 静 态 工 厂 类 

package cn.javass.spring.chapter3; 

import cn.javass.spring.chapter2.helloworld.HelloApi; 

public class DependencylnjectByStaticFactory { 

public static HelloApi newlnstance(String message, int index) { 
return new HellolImpl3(message, index); 


DDN 一 


.} 
.} 


Bis 


态 工厂 类 Bean 定 义 配 置 文件 (chapter3/staticFactoryDependencylnject.xml) 


一 


. <bean id="bylndex" 

2. class="cn.javass.spring.chapter3.DependencylnjectByStaticFactory" factory- 
method="newlnstance'"> 

. <constructor-arg index="0" value="Hello World!"/> 

. <constructor-arg index="1" value="1"/> 

</bean> 

<bean id="byType" 


~ DO 小 只 


class="cn.javass.spring.chapter3.DependencylnjectByStaticFactory" factory- 
method="newlnstance'"> 
8. <constructor-arg type="java.lang.String" value="Hello World!"/> 
9. <constructor-arg type="int" value="2"/> 
10. </bean> 
11. <bean id="byName" 
12. class="cn.javass.spring.chapter3.DependencylnjectByStaticFactory" factory- 
method="newlnstance'"> 
13. <constructor-arg name="message" value="Hello World!"/> 
14. <constructor-arg name="index" value="3"/> 
15. </bean> 


(2) 实例 工厂 类 


// 实 例 工厂 类 

package cn.javass.spring.chapter3; 

import cn.javass.spring.chapter2.helloworld.HelloApi; 
public class DependencylnjectBylnstanceFactory { 
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public HelloApi newlnstance(String message, int index) { 


6. return new HellolImpl3(message, index); 
7. } 
8. } 


实例 工厂 类 Bean 定 义 配 置 文件 (chapter3/instanceFactoryDependencylnject.xml) 


1. <bean id="instanceFactory" 


D 


class="cn.javass.spring.chapter3.DependencylnjectByInstanceFactory"/> 
3. <bean id="bylndex" 


. factory-bean="instanceFactory" factory-method="newlnstance"> 
. <constructor-arg index="0" value="Hello World!"/> 


4 
5 
6. <constructor-arg index="1" value="1"/> 
7. </bean> 

8. <bean id="byType" 

9. factory-bean="instanceFactory" factory-method="newlnstance"> 
10. <constructor-arg type="java.lang.String" value="Hello World!"/> 
11. <constructor-arg type="int" value="2"/> 
12. </bean> 
13. <bean id="byName" 

14. factory-bean="instanceFactory" factory-method="newlnstance'"> 
15. <constructor-arg name="message" value="Hello World!"/> 
16. <constructor-arg name="index" value="3"/> 


17. </bean> 


(3) 测试 代码 和 构造 器 方式 完全 一 样 ， 只 是 配置 文件 不 一 样 ， 大 家 只 需 把 测试 文件 改 一 下 就 
可 以 了 。 还 有 一 点 需要 大 家 注意 就 是 ee 
只 支持 通过 在 class 文 件 中 添加 “变量 调试 信息 "方式 才能 运行 ，ConstructorProperties 注 解 方式 
不 能 工作 ， 它 只 对 构造 器 方式 起 作用 ， ve 站 行 构造 器 注入 。 


3.1.3 setter 注 入 


setter 注 入 ， 是 通过 在 通过 构造 器 、 静 态 工厂 或 实例 工厂 实例 好 Bean 后 ， 通 过 调用 Bean 类 的 
setter 方 法 进行 注入 依赖 ， 如 图 3-3 所 示 : 
通过 容器 setter 注 入 传统 settetr 方 式 


<bean class="...Hellolmpl 4"> 1、 实 全 化 |Helloahl al = new HelloImpl40; 










<property name="message" vaue="Hello"/> |2、 豚 置 属性 | Api_ setMessaget"Hello"; 





<property name="index" vaue="1"/> 3、 置 居 性 | Ap1. setIndex 0' Hello" 1 





< 山 Eafi> 





图 3-3 setter 注 入 方式 
setter 注 入 方式 只 有 一 种 根据 setter 名 字 进 行 注 入 : 


指定 setterf 名 字 ， 比 如 
sethkyfessage 就 是 mmessage 


参数 值 


<property name="message" value="Hello World'"/> 





知道 配置 方式 了 ， 接 下 来 先 让 我 们 来 做 个 简单 例子 吧 。 
(1) 准备 测试 类 HellolImpl4， 需 要 两 个 setter 方 法 “setMessage” 和 “setindex”: 


package cn.javass.spring.chapter3; 

import cn.javass.spring.chapter2.helloworld.HelloApi; 
public class Hellolmpl4 implements HelloApi { 
private String message; 

private int index; 

//setter 方 法 

public void setMessage(String message) { 
this.message = message; 


public void setlndex(int index) { 
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. this.index = index; 


} 
@Override 
public void sayHello() { 


_、 ~ 
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System.out.println(index + ":" + Message); 


} 
17. } 


~、 
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(2) 配置 Bean 定 义 ， 具 体 配 置 文件 (resources/chapter3/setterDependencylnject.xml) 片 
段 如 下 : 


1，<!-- 通过 setter 方 式 进行 依赖 注入 --> 

2. <bean id="bean" class="cn.javass.spring.chapter3.Hellolmpl4"> 
3. <property name="message" value="Hello World!"/> 

4. <property name="index"> 

5. <value>1</value> 

6. </property> 

7. </bean> 


(3) 该 写 测试 进行 测试 一 下 是 否 满足 能 工作 了 ， 其 实测 试 代码 一 点 没 变 ， 变 的 是 配置 : 


@Test 

public void testSetterDependencylnject() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter3/setterDependencylnject.xml"); 
HelloApi bean = beanFactory.getBean("bean", HelloApi.class); 
bean.sayHello(); 


} 


知道 如 何 配置 了 ， 但 Spring 如 何 知道 setter 方 法 ? 如何 将 值 注入 进去 的 呢 ? 其 实 方法 名 是 要 遵 
守 约 定 的 ，setter 注 入 的 方法 名 要 遵循 “JavaBean getter/setter 方法 命名 约定 ”: 
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JavaBean : 是 本 质 就 是 一 个 POJO 类 ， 但 具有 一 下 限制 : 

该 类 必须 要 有 公共 的 无 参 构造 器 ， 如 public Hellolmpl4() 人; 

属性 为 private 访 问 级 别 ， 不 建议 public， 如 private String message; 
属性 必要 时 通过 一 组 setter (修改 器 ) 和 getter (访问 器 ) 方法 来 访问 ; 


setter 方 法 ， 以 “set” 开 头 ， 后 跟 首 字 母 大 写 的 属性 名 ， 如 “setMesssage”, 简 单 属性 一 般 只 有 
一 个 方法 参数 ， 方 法 返回 值 通常 为 “Void”; 

getter 方 法 ， 一 般 属性 以 “get” 开 头 ， 对 于 boolean 类 型 一 般 以 “is” 开 头 ， 后 跟 首 字母 大 写 的 属 
性 名 ， 如 “getMesssage” ，"“isOk”; 


还 有 一 些 其 他 特殊 情况 ， 比 如 属性 有 连续 两 个 大 写字 母 开头 ， 如 “URL”, 则 setter/getter 方 法 
为 : “setURL” 和 “getURL”， 其 他 一 些 特 殊 情 况 请 参看 "Java Bean" 命 名 规范 。 


3.1.4 注入 常量 
注入 常量 是 依赖 注入 中 最 简单 的 。 配 置 方式 如 下 所 示 : 


1. <property name="message" value="Hello World!"/> 

2. 或 

3. <property name="index"><value>1</value></property><span class="Apple-style-span" 
style="font-size: 14px; white-space: normal; background-color: #ffffff:"> </span> 


以 上 两 种 方式 都 可 以 ， 从 配置 来 看 第 一 种 更 简洁 。 注 意 此 处 “value” 中 指定 的 全 是 字符 囊 ， 由 
Spring 容器 将 此 字符 串 转换 成 属性 所 需要 的 类 型 ， 如 果 转 换 出 错 ， 将 抛 出 相应 的 异常 。 


Spring 容器 目前 能 对 各 种 基本 类 型 把 配置 的 String 参 数 转 换 为 需要 的 类 型 。 


注 : Spring 类 型 转换 系统 对 于 boolean 类 型 进行 了 容错 处 理 ， 除 了 可 以 使 用 "true/false” 标 准 的 
Java 值 进行 注入 ， 还 能 使 用 "yes/no"”、“on/off'、"1/0" 来 代表 “ 引 / 假 "， 所 以 大 家 在 学 习 或 工作 中 
遇 到 这 种 类 似 问 题 不 要 觉得 是 人 家 配置 错 了 ， 而 是 Spring 容错 做 的 非常 好 。 


1 测试 类 


public class Boolean TestBean { 

private boolean Success; 

public void setSuccess(boolean success) { 
this.success = success; 

} 

public boolean isSuccess() { 

return Success; 

} 


} 
. 配置 文件 (chapter3/booleanlnject.xml) 片段 : 


<!-- boolean 参 数值 可 以 用 on/off --> 
<bean id="bean2" class="cn.javass.spring.chapter3.bean.BooleanTestBean"> 


© PNONn 人 rmDND 


Ee EN 
NS 


<property name="success" value="on"/> 

</bean> 

<!-- boolean 参 数值 可 以 用 yes/no --> 

<bean id="bean3" class="cn.javass.spring.chapter3.bean.BooleanTestBean"> 
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<property name="success" value="yes"/> 

</bean> 

.<I-- boolean 参 数值 可 以 用 1/0 --> 

. <bean id="bean4" class="cn.javass.spring.chapter3.bean.BooleanTestBean"> 
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. <property name="success" value="1"/> 
</bean> 
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3.1.5 注入 Bean ID 


用 于 注入 Bean 的 ID，ID 是 一 个 常量 不 是 引用 ， 且 类 似 于 注入 常量 ， 但 提供 错误 验证 功能 ， 配 
置 方式 如 下 所 示 : 


1. <property name="id"><idref bean="bean1"/></property> 
1. <property name="id"><idref local="bean2"/></property> 


两 种 方式 都 可 以 ， 上 述 配置 本 质 上 在 运行 时 等 于 如 下 方式 


1. <bean id="bean1" class="...... "> 
2. <bean id="idrefBean1" class="...... "> 
3. <property name="id" value ="bean1"/> 


4. </bean> 


第 二 种 方式 (<idref bean="bean1"/>) 可 以 在 容器 初始 化 时 校 验 被 引用 的 Bean 是 否 存 在 ， 如 
果 不 存在 将 抛 出 异常 ， 而 第 一 种 方式 〈<idref local="bean2"/>) 只 有 在 Bean 实 际 使 用 时 才能 
发 现 传 入 的 Bean 的 ID 是 否 正确 ， 可 能 发 生 不 可 预料 的 错误 。 因 此 如 果 想 注入 Bean 的 ID， 推 荐 
使 用 第 二 种 方式 。 


接 下 来 学 习 一 下 如 何 使 用 吧 : 
首先 定义 测试 Bean : 


package cn.javass.spring.chapter3.bean 
public class IdRefTestBean { 

private String id; 

public String getld() { 

return id; 

} 

public void setld(String id) { 

this.id = id; 

} 

} 


其 次 定义 配置 文件 (chapter3/idReflnject.xml) 
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1. <bean id="bean1" class="java.lang.String"> 
2. <constructor-arg index="0" value="test"/> 
3. </bean> 

4. <bean id="bean2" class="java.lang.String"> 
5. <constructor-arg index="0" value="test"/> 
6. </bean> 


. <bean id="idrefBean1" class="cn.javass.spring.chapter3.bean.ldRefTestBean"> 
. <property name="id"><idref bean="bean1"/></property> 
.</bean> 


. <property name="id"><idref local="bean2"/></property> 


1 
2 
3 
4. <bean id="idrefBean2" class="cn.javass.spring.chapter3.bean.IdRefTestBean"> 
5 
6. </bean> 


从 配置 中 可 以 看 出 ， 注 入 的 Bean 的 ID 是 一 个 java.lang.String 类 型 ， 即 字符 串 类 型 ， 因 此 注入 
的 同样 是 常量 ， 只 是 具有 校 验 功能 。 


<idref bean="...... "/> 将 在 容器 初始 化 时 校 验 注入 的 ID 对 于 的 Bean 是 否 存 在 ， 如 果 不 存 在 将 抛 
出 异常 。 

<idref local="...... "> 将 在 XML 解析 时 校 验 注 入 的 ID 对 于 的 Bean 在 当前 配置 文件 中 是 否 存 在 ， 
如 果 不 存在 将 抛 出 异常 ， 它 不 同 于 <idref bean="...... ">，<idref local="...... "> 是 校 验 发 生 在 


XML 解析 式 而 非 容 器 初始 化 时 ， 且 只 检查 当前 配置 文件 中 是 否 存在 相应 的 Bean 。 


3.1.6 注入 集合 、 数 组 和 字典 


Spring 不 仅 能 注入 简单 类 型 数据 ， 还 能 注入 集合 (Collection、 无 序 集合 Set、 有 序 集合 List) 
类 型 、 数 组 (Array) 类 型 、 字 典 (Map) 类 型 数据 、Properties 类 型 数据 ， 接 下 来 就 让 我 们 一 个 个 
看 看 如 何 注 入 这 些 数 据 类 型 的 数据 。 

一 、 注 入 集合 类 型 : 包括 Collection 类 型 、Set 类 型 、List 类 型 数据 : 


(1) List 类 型 : 需要 使 用 <list> 标 签 来 配置 注入 ， 其 具体 配置 如 下 : 


1、 可 选 的 “value-type” 属 性 ， 表 示 列 表 中 条 目的 数据 的 类 型 ， 比 如 value- 
type= 扩 wwa lang.String[ 厂 不 列表 二 要 条 目 为 Suing 数 据 类 型 ; 


2、 也 可 以 采用 泛 型 ，Sprine 能 根据 沪 型 数据 自动 检测 科 List 里 条 目的 数据 类 型 ， 比 
如 java- util.List《String>, Spring 能 自动 识别 列表 需要 条 目 为 Suine 数 据 类 型 ; 


3、 如 果 既 没有 指定 “value-kpe” 属性 大 st 也 不 是 沙 弄 的 刚 默 认 就 是 String 类 型 ; 


<proparty natme 一 values'> 
15st value-type=""ijav. 
alue>1<malue> 
<alue>2<Aalue> 指定 列表 条 目 值 
<alue>3<Aalue 
地 list> 


后 边 再 介绍 ， 用 于 
父子 Bean 情况 是 否 
合并 list 条 目 ， 


propaty > 
<ibean> 





让 我 们 来 写 个 测试 来 练习 一 下 吧 : 
准备 测试 类 : 


package cn.javass.spring.chapter3.bean; 
import java.util.List; 

public class ListTestBean { 

private List<String> values; 

public List<String> getValues() { 

return values; 

} 

public void setValues(List<String> values) { 
this.values = values; 

10. } 

11. } 


OP 和 NO 


进行 Bean 定 义 ， 在 配置 文件 (resources/chapter3/listinject.xml) 中 配置 list 注 入 : 


1. <bean id="listBean" class="cn.javass.spring.chapter3.bean.ListTestBean"> 
2. <property name="Vvalues"> 
3. <list> 
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<value>1</value> 
<value>2</value> 
<value>3</value> 
</list> 

</property> 
</bean> 


测试 代码 : 


8. 


(2) Set 类 型 : 


DOAN 一 


@Test 


public void testListlnject() { 
BeanFactory beanFactory = 
new ClassPathXmlApplicationContext("chapter3/istlnject.xml”); 


ListTestBean listBean = beanFactory.getBean("listBean", ListTestBean.class); 


System.out.println(listBean.getValues().size()); 
Assert.assertEquals(3, listBean.getValues().size()); 


在 此 就 不 阅 述 了 : 


准备 测试 类 : 


=、 
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package cn.javass.spring.chapter3.bean; 

import java.util.Collection ; 

public class Collection TestBean { 

private Collection<String> values; 

public void setValues(Collection<String> values) { 
this.values = values; 


} 


public Collection<String> getValues() { 


return values; 


} 
} 


需要 使 用 <set> 标 签 来 配置 注入 ， 其 配置 参数 及 含义 和 <lsit> 标 签 完 全 一 样 ， 


进行 Bean 定 义 ， 在 配置 文件 (resources/chapter3/listinject.xml) 中 配置 list 注 入 : 
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<bean id="setBean" class="cn.javass.spring.chapter3.bean.SetTestBean"> 


<property name="values"> 


<Set> 
<value>1</value> 
<value>2</value> 
<value>3</value> 
</set> 


8. </property> 
9. </bean> 


具体 测试 代码 就 不 写 了 ， 和 listBean 测 试 代码 完全 一 样 。 


(2) Collection 类 型 : 因为 Collection 类 型 是 Set 和 List 类 型 的 基 类 型 ， 所 以 使 用 <set> 或 <list> 
标签 都 可 以 进行 注入 ， 配 置 方式 完全 和 以 上 配置 方式 一 样 ， 只 是 将 测试 类 属性 改 

成 “Collection”" 类 型 ， 如 果 配 置 有 问题 ， 可 参考 
cn.javass.spring.chapter3.DependencylnjectTest 测 试 类 中 的 testCollectionlnject 测 试 方法 中 的 
代码 。 


二 、 注 入 数组 类 型 : 需要 使 用 <array> 标 签 来 配置 注入 ， 其 中 标签 属性 “value- 
type” 和 “merge” 和 <list> 标 签 含义 完全 一 样 ， 具 体 配 置 如 下 : 


public class ArrayTestBean 1 
private strinyg[] array; 
private String[][] arrav2; 
public void sethrraylSstring[] array) 1 > 了 
this.array = array; 一 维 数 组 注入 
} 


public void sethrray2(String[][] array2}) 1{ 
this.array2 = array2; 二 维 煞 组 注入 


} 


<bean 工 呈 "arrayBean'" 
class"cn.J]avass. spring.chapter .lbean.BrrayTestBearl'> 
<property namE"array"> 
<array value type="java. lang. String" mendge="default"> 
<value>1</value> 
<value>2</value> 
</array> 
</property 
<property namE"array2"> 
<array 
<array 
<value>1l</value> 
</array 
array 
<value>4</value> 
</array 
</array> 
</propert 
</hean> 





如 果 练 习 时 遇 到 配置 问题 ， 可 以 参考 "cn.javass.spring.chapter3.DependencylnjectTest" 测 试 
类 中 的 testArraylnject 测 试 方法 中 的 代码 。 


三 、 注 入 字典 (Map) 类 型 : 字典 类 型 是 包含 键 值 对 数据 的 数据 结构 ， 需 要 使 用 <map> 标 签 
来 配置 注入 ， 其 属性 “key-type” 和 “value-type” 分 别 指定 “ 键 "和 “ 值 "的 数据 类 型 ， 其 含义 和 <list> 
标签 的 “value-type” 含 义 一 样 ， 在 此 就 不 罗 咏 了 ， 并 使 用 <key> 子 标签 来 指定 键 数据 ，<value> 
子 标签 来 指定 键 对 应 的 值 数据 ， 具 体 配 置 如 下 : 


1 1 对 应 的 类 文件 代码 
public class MapTestBeant 
private NamSstring, String> values; 
A 对 应 的 setter/getter 方 法 
Public void setVvalueadMap<String, String values) 1{ 2 
需要 注入 的 Ma 
thisvaluess vlLUuess 的 ?天 
} 
} 配置 
bean id="mapBean' 
Class="cn. javass.spring.chapter3 .bean.NMapTestBear'> 
roperty name='"values"> 
map key-tvype="java.lang.String' 
注入 value-t ype="java. lang.String"> 
ntry> 
¥ew <value>1l</value> </ key> | <key> 表 示 键 数据 
| walue>ili</value> | 
value>l11l</ value> | | value> 表 示 键 对 应 的 值 数据 
FEntry 










<map> 表 示 M 由 








<entry Ke 六"2" value="22"/> 喝 集 单 的 配置 方式 





propertw 
</hean> 


如 果 练 习 时 遇 到 配置 问题 ， 可 以 参考 "cn.javass.spring.chapter3.DependencylnjectTest" 测 试 
类 中 的 testMaplnject 测 试 方法 中 的 代码 。 


四 、Properties 注 入 : Spring 能 注入 java.util.Properties 类 型 数据 ， 需 要 使 用 <props> 标 签 来 配 
置 注 入 ， 键 和 值 类 型 必须 是 String， 不 能 变 ， 子 标签 <prop key=" 键 ”> 值 </prop> 来 指定 键 值 
， 具 体 配 置 如 下 : 


pblicclass PropertiesTestBeant{ 
private Properties values 
puwblic void setValuesProperties values 
thiawvalues = values; 


} 


<bean id"propertiesBeaw 


虽然 指定 了 value-type， 
<prop keE"1l">lsssc</prop> 但 其 实 该 属性 不 起 作用 ， 
<prop keyE"2">2 </ prop> Properties 刍 和信 全 是 
</props> String 类 型 
</:propertw 
</hean> 





publLic class PropertiesTestBeanl! 
private Properties values 
public void setVYaluesProperties values ({ 
thiavalues = values; 


tiesTestBeay»> 


分 陋 符 可 以 是 “换行 ”、“:”、“| 


</propertw 
</hean> 





如 果 练 习 时 遇 到 配置 问题 ， 可 以 参考 cn.javass.spring.chapter3.DependencylnjectTest 测 试 类 
中 的 testPropertieslnject 测 试 方法 中 的 代码 。 

到 此 我 们 已 经 把 简单 类 型 及 集合 类 型 介绍 完了 ， 大 家 可 能 会 问 怎么 没 见 注入 "Bean 之 问 关 

系 ” 的 例子 呢 ? 接 下 来 就 让 我 们 来 讲解 配置 Bean 之 间 依 赖 关系 ， 也 就 是 注入 依赖 Bean 。 


3.1.7 引用 其 它 Bean 

上 边 章 节 已 经 介绍 了 注入 常量 、 集 合 等 基本 数据 类 型 和 集合 数据 类 型 ， 本 小 节 将 介绍 注入 依 
赖 Bean 及 注入 内 部 Bean。 

引用 其 他 Bean 的 步骤 与 注入 常量 的 步骤 一 样 ， 可 以 通过 构造 器 注入 及 setter 注 入 引用 其 他 
Bean， 只 是 引用 其 他 Bean 的 注入 配置 稍微 变化 了 一 下 : 可 以 将 “<constructor-arg index="0" 
value="Hello World!"/>”" 和 “<property name="message" value="Hello World!y>” 中 的 value 属 
性 替换 成 bean 属 性 ， 其 中 bean 属 性 指定 配置 文件 中 的 其 他 Bean 的 id 或 别名 。 另 一 种 是 把 
<Vvalue> 标 签 替 换 为 <.ref bean="”beanName”>，bean 属 性 也 是 指定 配置 文件 中 的 其 他 Bean 的 
id 或 别名 。 那 让 我 们 看 一 下 具体 配置 吧 : 


一 、 构 造 器 注入 方式 : 


(1) 通过 ”<constructor-arg>” 标 签 的 ref 属 性 来 引用 其 他 Bean， 这 是 最 简化 的 配置 : 


<cConstructor-arg index="0"|Ivalue="Heilio! > 


<cConstructor-arg index="0"|ref="bean" > 


引用 * bean” 


<bean 1d="bean'" class 一 " 





(2) 通过 ”<constructor-arg>"” 标 签 的 子 <ref> 标 签 来 引用 其 他 Bean， 使 用 bean 属 性 来 指定 引 
用 的 Bean : 





二 、setter 注 入 方式 : 
(1) 通过 ”<property>" 标 签 的 ref 属 性 来 引用 其 他 Bean， 这 是 最 简化 的 配置 : 
<property nmame="message" 
<property mame="message" 


<beanid="bean" class="*……"/ 





(2) 通过 ”<property>" 标 签 的 子 <ref> 标 签 来 引用 其 他 Bean， 使 用 bean 属 性 来 指定 引用 的 
Bean : 


<property nmamec'"message"H<vwalue >HelloWorld lI</value> F/property> 
<property namec'"message"}ref bean="beanName" 六 <iproperty > | 注入 Bean 


<bean 1d="bean'" class 一 4 "fs 引用 ”bean” 


三 、 接 下 来 让 我 们 用 个 具体 例子 来 讲解 一 下 具体 使 用 吧 : 





(1) 首先 让 我 们 定义 测试 引用 Bean 的 类 ， 在 此 我 们 可 以 使 用 原 有 的 HelloApi 实 现 ， 然 后 再 定 
义 一 个 装饰 器 来 引用 其 他 Bean， 具 体 装 饰 类 如 下 : 


package cn.javass.spring.chapter3.bean; 

import cn.javass.spring.chapter2.helloworld.HelloApi; 
public class HelloApiDecorator implements HelloApi { 
private HelloApi helloApi; 

// 空 参 构 造 器 

public HelloApiDecorator() { 


} 
/有 参 构造 器 
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9. public HelloApiDecorator(HelloApi helloApi) { 
10. this.helloApi = helloApi; 
11. } 
12. public void setHelloApi(HelloApi helloApi) { 
13. this.helloApi = helloApi; 
14. } 
15. @Override 
16. public void sayHello() { 


17. System.out.printIn("========== 装 饰 一 下 ==========="); 
18. helloApi.sayHello(); 

19. System.out.println("========== 装 饰 一 下 ==========="); 
2 

21. } 


(2) 定义 好 了 测试 引用 Bean 接 下 来 该 在 配置 文件 (resources/chapter3/beanlnject.xml) 进 
置 Bean 定 义 了 ， 在 此 将 演示 通过 构造 器 及 setter 方 法 方式 注入 依赖 Bean : 


1.， <!-- 定义 依赖 Bean --> 

2. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
3. <!-- 通过 构造 器 注入 --> 

4. <bean id="bean1" class="cn.javass.spring.chapter3.bean.HelloApiDecorator"> 
5. <constructor-arg index="0" ref="helloApi"/> 

6. </bean> 

7. <!-- 通过 构造 器 注入 --> 

8. <bean id="bean2" class="cn.javass.spring.chapter3.bean.HelloApiDecorator"> 
9. <property name="helloApi"><ref bean=" helloApi"/></property> 
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10. </bean> 


和 


(3) 测试 一 下 吧 ， 测 试 代码 (cn.javass.spring.chapter3.DependencylnjectTest) 片 段 如 下 : 


@Test 

public void testBeanlnject() { 

BeanFactory beanFactory = 

new ClassPathXmlApplicationContext("chapter3/beanlnject.xm["); 
// 通 过 构造 器 方式 注入 

HelloApi bean1 = beanFactory.getBean("bean1", HelloApi.class); 
bean1.sayHello(); 

// 通 过 setter 方 式 注入 

HelloApi bean2 = beanFactory.getBean("bean2", HelloApi.class); 
bean2.sayHello(); 


一 上 mpaonmwnnn 一 
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四 、 其 他 引用 方式 : 除了 最 基本 配置 方式 以 外 ，Spring 还 提供 了 另外 两 种 更 高 级 的 配置 方式 ， 
<ref local=”/> 和 <ref parent=”/> : 


(1) <ref le6al=" 户 配置 方式 : 用 于 引用 通过 <bean id=”beanName”> 方 式 中 通过 id 属性 指定 

的 Bean， 它 能 利用 XML 解析 器 的 验证 功能 在 读 取 配 置 文件 时 来 验证 引用 的 Bean 是 否 存在 。 因 

此 如 果 在 当前 配置 文件 中 有 相互 引用 的 Bean 可 以 采用 <reflocal> 方 式 从 而 如 果 配 置 错 误 能 在 
开发 调试 时 就 发 现 错误 。 


如 果 引 用 一 个 在 当前 配置 文件 中 不 存在 的 Bean 将 抛 出 如 下 弄 常 : 


org.springframework.beans .factory.xml.XmlBeanDefinitionStoreException: Line21 inXML 
document from class path resource [chapter3/beanlnject2.xml] is invalid; nested exception is 
org.xml.sax.SAXParseException: cvc-id.1: There is no ID/IDREF binding for IDREF 
'helloApi.. 


<ref local> 具 体 配 置 方式 如 下 : 


前 提 条 件 ， 同 一 配置 文件 


<bean id="beani" Class=""" 


<bean name="bean?'" class= "> 


<alias alias'bean3'" name="beani "> 


</propertw 
</bhean> 





(2) <ref parent=”/> 配 置 方式 : 用 于 引用 父 容器 中 的 Bean， 不 会 引用 当前 容器 中 的 Bean， 
当然 父 容器 中 的 Bean 和 当前 容器 的 Bean 是 可 以 重 名 的 ， 获 取 顺 序 是 直接 到 父 容器 找 。 具 体 配 
置 方式 如 下 : 


父 容 器 配置 文件 


4Bean TE vedas 


将 引用 访 Bean 
<bean name="bean2" class="*""/> 2 


当前 配置 文件 


不 引用 二 
<bean name="bean2" class=""""/> 


<property name="prop'"> 引用 
<ref parent='bean2'/> 
</property> 
</ be an> 





接 下 来 让 我 们 用 个 例子 演示 一 下 <ref local> 和 <ref parent> 的 配置 过 程 


首先 还 是 准备 测试 类 ， 在 此 我 们 就 使 用 以 前 写 好 的 HelloApiDecorator 和 HellolImpl4 类 ; 其 次 进 
行 Bean 定 义 ， 其 中 当前 容器 bean13 引 用 本 地 的 "helloApi”， 而 "bean2” 将 引用 父 容器 
的 "helloApi”， 配 置 如 下 : 


<!-- Sources/chapter3/parentBeanlnject.xml 表 示 父 容器 配置 --> 
<!-- 注 意 此 处 可 能 子 容器 也 定义 一 个 该 Bean--> 

<bean id="helloApi" class="cn.javass.spring.chapter3.Hellolmpl4"> 
<property name="index" value="1"/> 

<property name="message" value="Hello Parent!"/> 

</bean> 
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<!-- sources/chapter3/localBeanlnject.xml 表 示 当 前 容器 配置 --> 

<!-- 注意 父 容器 中 也 定义 了 id 为 helloApi 的 Bean --> 

<bean id="helloApi" class="cn.javass.spring.chapter3.Hellolmpl4"> 

<property name="index" value="1"/> 

<property name="message" value="Hello Local!"/> 

</bean> 

<!-- 通过 local 注 入 --> 

<bean id="bean1" class="cn.javass.spring.chapter3.bean.HelloApiDecorator > 
<constructor-arg index="0"><ref local="helloApi"/></constructor-arg> 

</bean> 
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11. <!-- 通过 parent 注 入 --> 

12. <bean id="bean2" class="cn.javass.spring.chapter3.bean.HelloApiDecorator"> 
13. <property name="helloApi"><ref parent="helloApi"/></property> 

14. </bean> 


(3) 写 测试 类 测试 一 下 吧 ， 具 体 代码 片段 如 下 : 


@Test 

public void testLocalAndparentBeanlnject() { 

// 初 始 化 父 容器 

ApplicationContext parentBeanContext = 

new ClassPathXmlApplicationContext("chapter3/parentBeanlnject.xml”); 
/初始 化 当前 容器 

ApplicationContext beanContext = new ClassPathXmlApplicationContext( 
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new String[] {"chapter3/localBeanlnject.xml"}, parentBeanContext); 
9. HelloApi bean1 = beanContext.getBean("bean1", HelloApi.class); 

10. bean1.sayHello();// 该 Bean3 引 用 local bean 

11. HelloApi bean2 = beanContext.getBean("bean2", HelloApi.class); 

12. bean2.sayHello();// 该 Bean 引 用 parent bean 

13. } 


“bean1” 将 输出 “Hello Locall" 表 示 引 用 当前 容器 的 Bean，”bean2” 将 输出 “Hello Paren!”， 表 示 
引用 父 容 器 的 Bean， 如 配置 有 问题 请 参考 cn.javass.spring.chapter3.DependencylnjectTest 中 
的 testLocalAndparentBeanlnject 测 试 方法 。 


3.1.8 内 部 Bean 定 义 


内 部 Bean 就 是 在 <property> 或 <constructor-arg> 内 通过 <bean> 标 签 定 义 的 Bean， 该 Bean 不 
管 是 否 指定 id 或 name， 该 Bean 都 会 有 唯一 的 匿名 标识 符 ， 而 且 不 能 指定 别名 ， 该 内 部 Bean 
对 其 他 外 部 Bean 不 可 见 ， 有 具体 配置 如 下 : 


二 ] "rrr 
EONnSteuCtorarg rdet "0" 内 部 Bean 
<bhean nameEE7 las Mts 
<iconstructorarg> | 
<property name "prop"> 即使 指定 i 也 
<bean id"bearm?" classs" 


</propertw 


</ bean> 


内 部 Bean 对 外 部 
Bean 不 可 见 


<property name="prop"> 
<ref bean="bean2"/> 
</propertw 
</ bean> 


不 可 见 





(1) 让 我 们 写 个 例子 测试 一 下 吧 ， 具 体 配 置 文件 如 下 : 


. <bean id="bean" class="cn.javass.spring.chapter3.bean.HelloApiDecorator"> 
. <property name="helloApi"> 


.</property> 


1 
2 
3. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.HellolImp!l"/> 
4 
5. </bean> 


(2) 测试 代码 (cn.javass.spring.chapter3.DependencylnjectTest.testInnerBeanlnject) 


@Test 

public void testInnerBeanlinject() { 

ApplicationContext context = 

new ClassPathXmlApplicationContext("chapter3/innerBeanlnject.xml"); 
HelloApi bean = context.getBean("bean", HelloApi.class); 
bean.sayHello(); 


} 
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3.1.9 处 理 null 值 


Spring 通 ee 或 value 属 性 注入 常量 值 ， 所 有 注入 的 数据 都 是 字符 串 ， 那 如 何 注入 
null 值 呢 ? 通过 “nul" 值 吗 ? 当然 不 是 因为 如 果 注 入 “nul" 则 认为 是 字符 串 。Spring 通 过 <nully> 标 
ee 。 即 可 以 采用 如 下 配置 方式 : 


<bean class='...HelloImpl4"> 
<property name='message" ~>=null/=></property > 
<property name="index" value="1",> 

=/bean> 





3.1.10 对 象 图 导航 注入 支持 


所 谓 对 象 图 导航 是 指 类 似 a.b.c 这 种 点 组 访问 形式 的 访问 或 修改 值 。Spring 支 持 对 象 图 叶 航 方 
式 依赖 注入 。 对 象 图 导航 依赖 注入 有 一 个 限制 就 是 比如 a.b.c 对 象 导航 图 注入 中 a 和 b 儿 须 为 非 
null 值 才能 注入 c， 和 否则 将 抛 出 空 指针 异常 。 


Spring 不 仅 支持 对 象 的 导航 ， 还 支持 数组 、 列 表 、 字 典 、Properties 数 据 类 型 的 导航 ， 对 Set 
数据 类 型 无 法 支持 ， 因 为 无 法 导航 。 


数组 和 列表 数据 类 型 可 以 用 array[0] 、list[ 人 导航， 注意 虽 " 里 的 必须 是 数字 ， 因 为 是 按照 索引 
进行 导航 ， 对 于 数组 类 型 注意 不 要 数组 越界 错误 。 


字典 Map 数 据 类 型 可 以 使 用 map[1]、map[stn] 进 行 导 航 ， 其 中 器" 里 的 是 基本 类 型 ， 无 法 放置 引 
用 类 型 。 


让 我 们 来 练习 一 下 吧 。 首 先 准 备 测试 类 ， 在 此 我 们 需要 三 个 测试 类 ， 以 便 实 现 对 象 图 导航 功 


能 演示 : 


NavigationC 类 用 于 打印 测试 代码 ， 从 而 观察 配置 是 否 正确 ; 具体 类 如 下 所 示 : 


. package cn.javass.spring.chapter3.bean.; 
. public class NavigationC { 
. public void sayNavigation() { 


.} 

.} 
NavigationB 类 ， 包 含 对 象 和 列表 、Properties、 数 组 字典 数据 类 型 导航 ， 而 且 这 些 复 合 数 据 
类 型 保存 的 条 目 都 是 对 象 ， 正 好 练习 一 下 如 何 往复 合 数 据 类 型 中 注入 对 象 依赖 。 具 体 类 如 下 
所 示 : 


1 
2 
3 
4. System.out.println("===navigation ce"); 
5 
6 


package cn.javass.spring.chapter3.bean; 
import java.util.List; 

import java.util.Map; 

import java.util.Properties; 

public class NavigationB { 

private NavigationC navigationC; 

private List<NavigationC> list; 

private Properties properties; 
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private NavigationC[] array = new NavigationC[1]; 

10. private Map<String, NavigationC> map; 

11. /由 于 setter 和 getter 方 法 占用 太 多 空间 ， 故 省 略 ， 大 家 自己 实现 吧 
12. } 


NavigationA 类 是 我 们 的 前 端 类 ， 通 过 对 它 的 导航 进行 注入 值 ， 具 体 代码 如 下 : 


package cn.javass.spring.chapter3.bean; 

public class NavigationA { 

private NavigationB navigationB; 

public void setNavigationB(NavigationB navigationB ) { 
this.navigationB = navigationB; 

} 

public NavigationB getNavigationB() { 

return navigationB; 

} 

} 
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接 下 来 该 进行 Bean 定 义 配 置 〈resources/chapter3/navigationBeanlnject.xml) 了 ， 首 先 让 我 
们 配置 一 下 需要 被 导航 的 数据 ，NavigationC 和 NavigationB 类 ， 其 中 配置 NavigationB 时 注意 


要 确保 比如 array 字 段 不 为 空 值 ， 这 就 需要 或 者 在 代码 中 赋值 如 "NavigationC[] array = new 


NavigationC[1];”， 或 者 通过 配置 文件 注入 如 “<list></list>” 注 入 一 个 不 包含 条 目的 列表 。 具 体 配 


置 如 下 : 


. <bean id="c" class="cn.javass.spring.chapter3.bean.NavigationC"/> 
. <bean id="b" class="cn.javass.spring.chapter3.bean.NavigationB"> 
. <property name="list"><list></list></property> 


1 

2 

3 

4. <property name="map"><map></map></property> 

5. <property name="properties"><props></props></property> 
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. </bean> 


配置 完 需 要 被 导航 的 Bean 定 义 了 ， 该 来 配置 NavigationA 寻 航 Bean 了， 在 此 需要 注意 ， 由 


于 “navigationB” 属 性 为 空 值 ， 在 此 需要 首先 注入 “navigationB” 值 ; 还 有 对 于 数组 导航 不 能 
否则 报错 ; 具体 配置 如 下 : 


1. <bean id="a" class="cn.javass.spring.chapter3.bean.NavigationA"> 
2. <!-- 首先 注入 navigatiionB 确保 它 非 空 --> 

3. <property name="navigationB" ref="b"/> 

4.，<!-- 对 象 图 导航 注入 --> 

5. <property name="navigationB.navigationC" ref="c"/> 
6. <!-- 注入 列表 数据 类 型 数据 --> 

7. <property name="navigationB .list[0]" ref="c"/> 
8，<I-- 注入 map 类 型 数据 --> 

9. <property name="navigationB.mapl[key]" ref="c"/> 
10. <!-- 注入 properties 类 型 数据 --> 

11. <property name="navigationB.properties[0]" ref="c"/> 
12. <!-- 注入 properties 类 型 数据 --> 

13. <property name="navigationB.properties[1]" ref="c"/> 
14. <!-- 注入 数组 类 型 数据 ， 注 意 不 要 越界 --> 


办 


15. <property name="navigationB.array[0]" ref="c"/> 
16. </bean> 


配置 完毕 ， 具 体 测试 代码 在 cn.javass.spring.chapter3. DependencylnjectTest， 让 我 们 看 下 测 
试 代码 吧 : 


// 对 象 图 导航 

@Test 

public void testNavigationBeanlnject() { 

ApplicationContext context = 

new ClassPathXmlApplicationContext("chapter3/navigationBeanlnject.xml"); 
NavigationA navigationA = context.getBean("a", NavigationA.class); 
navigationA.getNavigationB().getNavigationC().sayNavigation(); 


DDN 一 


navigationA.getNavigationB().getList().get(0).sayNavigation(); 

9. navigationA.getNavigationB().getMap!().get("key").sayNavigation!(); 
10. navigationA.getNavigationB().getArray()[0].sayNavigation(); 

11. ((NavigationC)navigationA.getNavigationB().getProperties().get("1")) 
12. .sayNavigation(); 

13. } 


测试 完毕 ， 应 该 输出 5 个 “===navigation c”， 是 不 是 很 简单 ， 注 意 这 种 方式 是 不 推荐 使 用 的 ， 
了 解 一 下 就 够 了 ， 最 好 使 用 3.1.5 一 节 使 用 的 配置 方式 。 


3.1.11 配 置 简写 


让 我 们 来 总 结 一 下 依赖 注入 配置 及 简写 形式 ， 其 实 我 们 已 经 在 以 上 部 分 穿插 着 进行 简化 配置 


简写 : <constructor-arg index="0" value=" 常 量 "/> 

全 写 : <constructor-arg index="0"><value> 常 量 </value></constructor-arg> 
2) 引用 

简写 : <constructor-arg index="0" ref=" 引 用 "/> 

全 写 : <constructor-arg index="0"><ref bean=" 引 用 "/></constructor-arg> 
二 、setter 注 入 : 


1) 常量 值 


hd 


简写 : <property name="message" value=" 常 量 "/> 


全 写 : <property name="message"><value> 常 量 </value></ property> 
2) 引用 

简写 : <property name="message" ref=" 引 用 "/> 

全 写 : <property name="message"><ref bean=" 引 用 "/></ property> 

3) 数组 : <array> 没 有 简写 形式 

4) 列表 : <list> 没 有 简写 形式 

5) 集合 : <set> 没 有 简写 形式 

6) 字典 

简写 : <map> 

<entry key=" 键 常量 " value=" 值 常量 "/> 

<entry key-ref=" 键 引用 " value-ref=" 值 引用 "/> 

</map> 

全 写 : <map> 

<entry><key><value> 键 常量 </value></key><value> 值 常量 </value></entry> 
<entry><key><ref bean=" 键 引用 "/></key><ref bean=" 值 引用 "/></entry> 
</map> 

7) Properties : 没有 简写 形式 

三 、 使 用 p 命 名 空间 简化 setter 注 入 : 

使 用 p 命 名 空间 来 简化 setter 注 入 ， 具 体 使 用 如 下 : 


. <?xml version="1.0" encoding="UTF-8"?> 

. <beans xmlns="http://www.springframework.org/schema/beans" 
. xmlns:xsi="http:/www.w3.org/2001/XMLSchema-instance" 

. xmlns:p="http://www.springframework.org/schema/p" 

. Xxsi:schemaLocation=" 


. http:/www.springframework.org/schema/beans/spring-beans-3.0.xsd"&gt; 
. <bean id="bean1" class="java.lang.String"> 

. <constructor-arg index="0" value="test"/> 

.</bean> 


1 

2 

3 

4 

5 

6. http://www.springframework.org/schema/beans 
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1. <bean id="idrefBean1" class="cn.javass.spring.chapter3.bean.IdRefTestBean" 


12. 
13. 
14. 
15. 


16. 


17. 


p:id="value"/> 

<bean id="idrefBean2" class="cn.javass.spring.chapter3.bean.IdRefTestBean" 
p:id-ref="bean1"/> 

</beans> 


xmlns:p="http://www.springframework.org/schema/p"” : 首先 指定 p 命 名 空间 ; 


<bean id="......" class="......" p:id="value"/> : 常量 setter 注 入 方式 ， 其 等 价 于 
<property name="id" value="value'"/> ; 


oO 


sm <bean id="......" class="......" p:id-ref="bean1"/> : 引用 setter 注 入 方式 ， 其 


等 价 于 <property name="id" ref="bean1"/>。 


原创 内 容 ， 转 载 请 注 明 【http://sishuok.com/forum/posts/list/2447.html]】 


【第 三 章 】DI 之 3.2 循环 依赖 





3.2.1 什么 是 循环 依赖 


循环 依赖 就 是 循环 引用 ， 就 是 两 个 或 多 个 Bean 相 互 之 间 的 持 有 对 方 ， 比 如 CircleA 引 用 
CircleB，CircleB 引 用 CircleC，CircleC 引 用 CircleA， 则 它们 最 终 反 映 为 一 个 环 。 此 处 不 是 循 
环 调用 ， 循 环 调用 是 方法 之 间 的 环 调用 。 如 图 3-5 所 示 : 












图 3-5 循环 引用 


循环 调用 是 无 法 解决 的 ， 除 非 有 终结 条 件 ， 否 则 就 是 死 循环 ， 最 终 导 致 内 存 溢出 错误 。 


Spring 容器 循环 依赖 包括 构造 器 循环 依赖 和 setter 循 环 依赖 ， 那 Spring 容器 如 何 解决 循环 依赖 
呢 ? 首先 让 我 们 来 定义 循环 引用 类 : 


1. package cn.javass.spring.chapter3.bean; 
2. public class CircleA { 
3. private CircleB circleB; 
4. public CircleA(){ 
5. } 
6. public CircleA(CircleB circleB) { 
7. this.circleB = circleB; 
8. } 
9. public void setCircleB(CircleB circleB) 
10. { 
11. this.circleB = circleB; 
12. } 
13. public void al() { 
14. circleB.b(); 
15. } 
16. } 


1. package cn.javass.spring.chapter3.bean; 
2. public class CircleB { 


16. 
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. Private CircleC circleC; 
. public CircleB() { 


} 


. public CircleB(CircleC circleC) { 
. this.circleC = circleC; 


l; 


. public void setCircleC(CircleC circleC) 


| 


. this.circleC = circleC; 


} 


. public void b() { 
. CircleC.c(); 


} 
} 


. package cn.javass.spring.chapter3.bean.; 
. public class CircleC { 

. Private CircleA circleA; 

. public CircleC() { 


} 


. public CircleC(CircleA circleA) { 
. this.circleA = circleA; 


} 


. public void setCircleA(CircleA circleA) 
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. this.circleA = circleA; 
. } 

. public void c() { 

. CircleA.a(); 


} 
} 


3.2.2 Spring 如 何 解 决 循环 依赖 


一 、 构 造 器 循环 依赖 : 表示 通过 构造 器 注入 构成 的 循环 依赖 ， 此 依赖 是 无 法 解决 的 ， 只 能 抛 
出 BeanCurrentlyInCreationException 异 常 表示 循环 依赖 。 


如 在 创建 CircleA 类 时 ， 构 造 器 需要 CircleB 类 ， 那 将 去 创建 CircleB， 在 创建 CircleB 类 时 又 发 现 
需要 CircleC 类 ， 则 又 去 创建 CircleC， 最 终 在 创建 CircleC 时 发 现 又 需要 CircleA ; 从 而 形成 一 
个 环 ， 没 办 法 创建 。 


Spring 容器 将 每 一 个 正在 创建 的 Bean 标识 符 放 在 一 个 “当前 创建 Bean 池 "中 ，Bean 标 识 符 在 创 
建 过 程 中 将 一 直 保 持 在 这 个 池 中 ， 因 此 如 果 在 创建 Bean 过 程 中 发 现 自己 已 经 在 “当前 创建 
Bean 池 ”里 时 将 抛 出 BeanCurrentlyInCreationException 异 常 表示 循环 依赖 ; 而 对 于 创建 完毕 
的 Bean 将 从 “当前 创建 Bean 池 ”中 清除 掉 。 


1) 首先 让 我 们 看 一 下 配置 文件 (chapter3/circlelnjectByConstructor.xml) 


. <bean id="circleA" class="cn.javass.spring.chapter3.bean.CircleA"> 
. <constructor-arg index="0" ref="circleB"/> 

.</bean> 

. <bean id="circleB" class="cn.javass.spring.chapter3.bean.CircleB"> 


1 
2 
3 
4 
5. <constructor-arg index="0" ref="circleC"/> 
6. </bean> 

7. <bean id="circleC" class="cn.javass.spring.chapter3.bean.CircleC"> 
8. <constructor-arg index="0" ref="circleA"/> 
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.</bean> 
2) 写 段 测试 代码 (cn.javass.spring.chapter3.CircleTest) 测试 一 下 吧 : 


@Test(expected = BeanCurrentlyInCreationException.class) 

public void testCircleByConstructor() throws Throwable { 

try { 

new ClassPathXmlApplicationContext("chapter3/circlelnjectByConstructorxml”); 
} 

catch (Exception e){ 

// 因 为 要 在 创建 circle3 时 抛 出 ; 

Throwable e1 = e.getCause().getCause().getCause(); 


OP 和 NO 


throw e1; 
10. } 
11. } 


让 我 们 分 析 一 下 吧 : 


1、Spring 容 器 创建 “circleA” Bean， 首 先 去 “当前 创建 Bean 池 ”查找 是 否 当 前 Bean 正 在 创建 ， 
如 果 没 发 现 ， 则 继续 准备 其 需要 的 构造 器 参数 “circleB”， 并 将 “circleA” 标识 符 放 到 “当前 创建 
Bean 池 ”; 


2、Spring 容 器 创建 “circleB” Bean ， 首 先 去 “当前 创建 Bean 池 "查找 是 否 当 前 Bean 正 在 创建 ， 
如 果 没 发 现 ， 则 继续 准备 其 需要 的 构造 器 参数 “circleC”， 并 将 “circleB” 标识 符 放 到 “当前 创建 
Bean 池 ”; 


3、Spring 容 器 创建 “circleC” Bean， 首 先 去 “当前 创建 Bean 池 "查找 是 否 当前 Bean 正 在 创建 ， 
如 果 没 发 现 ， 则 继续 准备 其 需要 的 构造 器 参数 “circleA”， 并 将 “circleC” 标识 符 放 到 “当前 创建 
Bean 池 ”; 


4、 到 此 为 止 Spring 容 器 要 去 创建 “circleA"Bean， 发 现 该 Bean 标识 符 在 “当前 创建 Bean 
池 ?” 中 ， 因 为 表示 循环 依赖 ， 抛 出 BeanCurrentlyInCreationException 。 


二 、setter 循 环 依赖 : 表示 通过 setter 注 入 方式 构成 的 循环 依赖 。 


对 于 setter 注 入 造成 的 依赖 是 通过 Spring 容器 提前 暴露 刚 完成 构造 器 注入 但 未 完成 其 他 步骤 
(如 setter 注 入 ) 的 Bean 来 完成 的 ， 而 且 只 能 解决 单 例 作用 域 的 Bean 循 环 依赖 。 


如 下 代码 所 示 ， 通 过 提前 暴露 一 个 单 例 工厂 方法 ， 从 而 使 其 他 Bean 能 引用 到 该 Bean 。 


addSingletonFactory(beanName, new ObjectFactory() { 
public Object getObject() throws BeansException { 
return getEarlyBeanReference(beanName, mbd, bean); 
} 

)); 


具体 步骤 如 下 : 
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1、Spring 容 器 创建 单 例 “circleA”Bean， 首 先 根 据 无 参 构造 器 创建 Bean， 并 暴露 一 
个 “ObjectFactory "用 于 返回 一 个 提 人 | 建 中 的 Bean， 并 将 “circleA” 标识 符 放 到 “当前 
创建 Bean 池 ”; 然后 进行 Setter 注 入 “circleB” 


2、Spring 容 器 创建 单 例 “circleB”Bean， 首 先 根 据 无 参 构 造 器 创建 Bean， 并 暴露 一 
个 “ObjectFactory" 用 于 返回 一 个 提前 暴露 一 个 创建 中 的 Bean， 并 将 “circleB” 标 识 符 放 到 “当前 
创建 Bean 池 ”， 然 后 进行 setter 注 入 “circleC” 


3、Spring 容 器 创建 单 例 “circleC” Bean， 首 先 根 据 无 参 构造 器 创建 Bean， 并 暴露 一 

个 “ObjectFactory "用 于 返回 一 个 提前 暴露 一 个 创建 中 的 Bean， 并 将 “circleC” 标识 符 放 到 “当前 
创建 Bean 池 ”， 然 后 进行 setter 注 入 “circleA”; 进行 注入 “circleA" 时 由 于 提前 暴露 

了 “ObjectFactory” 工 厂 从 而 使 用 它 返 回 提 前 暴露 一 个 创 1 建 中 的 Bean ; 


4、 最 后 在 依赖 注入 “circleB” 和 “circleA”， 完 成 setter 注 入 。 


对 于 “prototype” 作 用 域 Bean，Spring 容 器 无 法 完成 依赖 注入 ， 因 为 “prototype” 作 用 域 的 
Bean，Spring 容 器 不 进行 缓存 ， 因 此 无 法 提前 暴露 一 个 创建 中 的 Bean。 


日 


<!-- 定义 Bean 配 置 文件 ， 注 意 scope 都 是 “prototype”--> 

<bean id="circleA" class="cn.javass.spring.chapter3.bean.CircleA" scope="prototype"> 
<property name="circleB" ref="circleB"/> 

</bean> 

<bean id="circleB" class="cn.javass.spring.chapter3.bean.CircleB" scope="prototype"> 
<property name="circleC" ref="circleC"/> 

</bean> 


<bean id="circleC" class="cn.javass.spring.chapter3.bean.CircleC" scope="prototype"> 


OP 和 NO 


<property name="circleA" ref="circleA"/> 
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</bean> 


// 测 试 代码 cn.javass.spring.chapter3.CircleTest 

@Test(expected = BeanCurrentlyInCreationException.class) 

public void testCircleBySetterAndPrototype () throws Throwable { 

try { 

ClassPathXmlApplicationContext ctx = new ClassPathXmlApplicationContext( 
"chapter3/circlelnjectBySetterAndPrototype.xml"); 
System.out.printin(ctx.getBean("circleA")); 


} 


catch (Exception e){ 


OP 和 NO 
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Throwable e1 = e.getCause().getCause().getCause(); 


一 
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. throw e1; 


} 
13. } 
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对 于 “singleton” 作 用 域 Bean， 可 以 通过 “setAllowCircularReferences(false);” 来 禁用 循环 引 
用 : 


@Test(expected = BeanCurrentlyInCreationException.class) 

public void testCircleBySetterAndSingleton2() throws Throwable { 

try { 

ClassPathXmlApplicationContext ctx = 

new ClassPathXmlApplicationContext(); 
ctx.setConfigLocation("chapter3/circlelnjectBySetterAndSingleton.xm[I"); 
ctx.refresh(); 


1 


catch (Exception e){ 
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Throwable e1 = e.getCause().getCause().getCause(); 


~、 
~、 


. throw e1; 


} 
13. } 


一 人 
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补充 : 出 现 循环 依赖 是 设计 上 的 问题 ， 一 定 要 避免 | 
请 参考 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》 中 的 “无 环 依赖 ?原则 


包 之 间 的 依赖 结构 必须 是 一 个 直接 的 无 环 图 形 (DAG) 。 也 就 是 说 ， 在 依赖 结构 中 不 允许 出 
现 环 (循环 依赖 ) 。 


原创 内 容 转载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2448.html#7070]】 


【第 三 章 】DI 之 3.3 更 多 DI 的 知识 
spring3 
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3.3.1 延迟 初始 化 Bean 


延迟 初始 化 也 叫做 惰性 初始 化 ， 指 不 提前 初始 化 Bean， 而 是 只 有 在 卜 正 使 用 时 才 创 建 及 初始 
化 Bean。 


方式 很 简单 只 需 在 <bean> 标 签 上 指定 “|azy-init” 属性 值 为 true” 即 可 延迟 初始 化 Bean 。 


Spring 容器 会 在 创建 容器 时 提前 初始 化 “singleton” 作 用 域 的 Bean ，“singleton” 就 是 单 例 的 意思 
即 整个 容器 we 个 实例 ， 后 边 会 详细 介绍 。Spring 容 器 预先 初始 化 Bean 通 常 能 帮 
助 我 们 提前 发 现 配 置 错 误 ， 所 以 如 果 没 有 什么 情况 建议 开启 ， 除 非 有 某 个 Bean 可 能 需要 加 载 
很 大 资源 ， 而 且 很 可 能 在 整个 应 用 程序 生命 周期 中 很 可 能 使 用 不 到 ， 可 以 设置 为 延迟 初始 

化 。 


延迟 初始 化 的 Bean 通 常会 在 第 一 次 使 用 时 被 初始 化 ; 或 者 在 被 非 延 迟 初 始 化 Bean 作 为 依赖 对 
象 注入 时 在 会 随 着 初始 化 该 Bean 时 被 初始 化 ， 因 为 在 这 时 使 用 了 延迟 初始 化 Bean。 


容器 管理 初始 化 Bean 消 除了 编程 实现 延迟 初始 化 ， 完 全 由 容器 控制 ， 只 需 在 需要 延迟 初始 化 
的 Bean 定 义 上 配置 即 可 ， 比 编程 方式 更 简单 ， 而 且 是 无 侵入 代码 的 。 


具体 配置 如 下 : 


1. <bean id="helloApi" 
2. class="cn.javass.spring.chapter2.helloworld.Hellolmpl" 
3. lazy-init="true"/> 


3.3.2 使 用 depends-on 


depends-on 是 指 指定 Bean 初 始 化 及 销毁 时 的 顺序 ， 使 用 depends-on 属 性 指定 的 Bean 要 先 初 
始 化 完毕 后 才 初 始 化 当前 Bean， 由 于 只 有 : 9 Ge 被 Spring 管理 销 毁 ， 所 以 当 指 定 
的 Bean 都 是 “singleton" 时 ， 使 用 depends-on 属 性 指定 的 Bean 要 在 指定 的 Bean 之 后 销毁 。 


配置 方式 如 下 : 


1. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
2. <bean id="decorator 

3. class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 

4. depends-on="helloApi"> 

5. <property name="helloApi"><ref bean="helloApi"/></property> 

6. </bean> 


“decorator" 指定 了 “depends-on” 属 性 为 “helloApi”， 所 以 在 “decoratorBean 初 始 化 之 前 要 先 初 
始 化 "helloApi”， 而 在 销毁 “helloApi" 之 前 先 要 销毁 “decoratom， 大 家 注意 一 下 销毁 顺序 ， 与 文 
档 上 的 不 符 。 


“depends-on" 属 性 可 以 指定 多 个 Bean， 若 指定 多 个 Bean 可 以 用 “2”"、“%”、 空格 分 割 。 


那 “depends-on?* 有 什么 好 处 呢 ? 主要 是 给 出 明确 的 初始 化 及 销毁 顺序 ， 比 如 要 初始 

化 “decorator 时 要 确保 "helloApi"Bean 的 资源 准备 好 了 ， 和 否则 使 用 "decorator 时 会 看 不 到 准备 
的 资源 ; 而 在 销毁 时 要 先 在 “decoratorBean 的 把 对 “helloApi 资 源 的 引用 释放 掉 才 能 销 

毁 “helloAp， 否 则 可 能 销毁 “helloApi" 时 而 “decorator 还 保持 着 资源 访问 ， 造 成 资源 不 能 释放 
或 释放 错误 。 


让 我 们 看 个 例子 吧 ， 在 平常 开发 中 我 们 可 能 需要 访问 文件 系统 ， 而 文件 打开 、 关 闭 是 必须 配 
对 的 ， 不 能 打开 后 不 关闭 ， 从 而 造成 其 他 程序 不 能 访问 该 文件 。 让 我 们 来 看 具体 配置 吧 : 


1) 准备 测试 类 : 


ResourceBean 从 配置 文件 中 配置 文件 位 置 ， 然 后 定义 初始 化 方法 init 中 打开 指定 的 文件 ， 然 后 
获取 文件 流 ; 最 后 定义 销毁 方法 destroy 用 于 在 应 用 程序 关闭 时 调用 该 方法 关闭 掉 文 件 流 。 


DependentBean 中 会 注入 ResourceBean， 并 从 ResourceBean 中 获取 文件 流 写 入 内 容 ; 定义 
初始 化 方法 init 用 来 定义 一 些 初 始 化 操作 并 向 文件 中 输出 文件 头 信息 ; 最 后 定义 销毁 方法 用 于 
在 关闭 应 用 程序 时 想 文 件 中 输出 文件 尾 信 息 。 


具体 代码 如 下 : 


package cn.javass.spring.chapter3.bean; 
import java.io.File; 

import java.io.FileNotFoundException; 
import java.io.FileOutputStream:; 

import java.io.IJOException; 

public class ResourceBean { 

private FileOutputStream fos; 

private File file; 

// 初 始 化 方法 

public void init() { 
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try{ 
this.fos = new FileOutputStream(file); 
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} catch (FileNotFoundException e){ 
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e.printStackTrace(); 
} 
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} 


.// 销 毁 资 源 方法 
. public void destroy() { 


. try{ 


fos.close(); 


. } catch (IOException e) { 


e.printStackTrace(); 
} 


.} 

. public FileOutputStream getFos() { 
. return fos; 

.} 

. public void setFile(File file) { 


this.file = file; 


.} 
.} 


package cn.javass.spring.chapter3.bean; 
import java.io.IOException,; 

public class DependentBean { 

ResourceBean resourceBean; 

public void write(String ss) throws IOException { 


resourceBean.getFos().write(ss.getBytes()); 


} 
/初始 化 方法 
public void init() throws IOException { 


} 
// 销 毁 方法 
public void destroy() throws IOException { 


} 


. public void setResourceBean(ResourceBean resourceBean) { 


".getBytes()); 


".getBytes()); 


21. this.resourceBean = resourceBean; 
22. } 
23. } 


2) 类 定义 好 了 ， 让 我 们 来 进行 Bean 定 义 吧 ， 具 体 配置 文件 如 下 : 


. <bean id="resourceBean" 

. Class="cn.javass.spring.chapter3.bean.ResourceBean" 
. init-method="init" destroy-method="destroy"> 

. <property name="file" value="D:/test.txt"/> 

.</bean> 


. Class="cn.javass.spring.chapter3.bean.DependentBean" 
. init-method="init" destroy-method="destroy" depends-on="resourceBean"> 
. <property name="resourceBean" ref="resourceBean"/> 


1 
2 
3 
4 
5 
6. <bean id="dependentBean" 
7 
8 
9 
10. 


</bean> 


<property name="file" value="D:/test.txt"/> 配 置 : Spring 容器 能 自动 把 字符 串 转 换 为 
java.io.File。 


init-method="init”: 指定 初始 化 方法 ， 在 构造 器 注入 和 setter 注 入 完毕 后 执行 。 


destroy-method="destroy" : 指定 销毁 方法 ， 只 有 “singleton” 作 用 域 能 销毁 ，"prototype" 作 
用 域 的 一 定 不 能 ， 其 他 作用 域 不 一 定 能 ; 后 边 再 介绍 。 


在 此 配置 中 ，resourceBean 初 始 化 在 dependentBean 之 前 被 初始 化 ，resourceBean 销 毁 会 在 
dependentBean 销 毁 之 后 执行 。 


3) 配置 完毕 ， 测 试 一 下 吧 : 


package cn.javass.spring.chapter3; 

import java.io.IJOException; 

import org.junit. Test; 

import org.springframework.context.support.ClassPathXmlApplicationContext; 
import cn.javass.spring.chapter3.bean.DependentBean; 

public class MoreDependencylnjectTest { 

@Test 

public void testDependOn!() throws IOException { 


mA 一 


ClassPathXmlApplicationContext context = 


一 人 


new ClassPathXmlApplicationContext("chapter3/depends-on.xml"); 
. /一 点 要 注册 销毁 回调 ， 否 则 我 们 定义 的 销毁 方法 不 执行 
context.registerShutdownHook(); 
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DependentBean dependentBean = 


~、 


context.getBean("dependentBean", DependentBean.class); 


15. dependentBean.write("aaa"); 

16. } 

17. } 

测试 跟 其 他 测试 完全 一 样 ， 只 是 在 此 我 们 一 定 要 注册 销毁 方法 回调 ， 否 则 销毁 方法 不 会 执 
行 。 


如 果 配 置 没 问题 会 有 如 下 输出 : 


1. ResourceBean:======== 初 始 化 

2. ResourceBean:======== 加 载 资 源 ， 执 行 一 些 预 操作 

3. DependentBean:========= 初 始 化 
4，DependentBean:========= 写 资源 

5. DependentBean:========= 销 毁 
6，ResourceBean:======== 销 毁 
7，ResourceBean:======== 释 放 资 源 ， 执 行 一 些 清理 操作 


3.3.3 上 自动 装配 

自动 装配 就 是 指 由 Spring 来 自动 地 注入 依赖 对 象 ， 无 需 人 工 参 与 。 

目前 Spring3.0 支 持 “no”、“byName ”、“byType”、“constructor” 四 种 自动 装配 ， 默 认 是 “no” 指 
不 支持 自动 装配 的 ， 其 中 Spring3.0 已 不 推荐 使 用 之 前 版 本 的 “autodetect" 自 动 装配 ， 推 荐 使 用 
Java 5+ 支 持 的 (@Autowired) 注解 方式 代替 ; 如 果 想 支持 “autodetect" 自 动 装配 ， 请 将 
schema 改 为 “spring-beans-2.5.xsd” 或 去 掉 。 

自动 装配 的 好 处 是 减少 构造 器 注入 和 setter 注 入 配置 ， 减 少 配置 文件 的 长 度 。 自 动 装配 通过 配 
置 <bean> 标 签 的 “autowire” 属 性 来 改变 自动 装配 方式 。 接 下 来 让 我 们 挨 着 看 下 配置 的 含义 。 
一 、default : 表示 使 用 默认 的 自动 装配 ， 默 认 的 自动 装配 需要 在 <beans> 标 签 中 使 用 default- 


autowire 属 性 指定 ， 其 支持 “ho”、“byName ”、“byType”、“constructor" 四 种 自动 装配 ， 如 果 需 
要 履 盖 默认 自动 装配 ， 请 继续 往 下 看 ; 


二 、no : 意思 是 不 支持 自动 装配 ， 必 须 明 确 指定 依赖 。 


三 、byName : 通过 设置 Bean 定 义 属性 autowire="byName"， 意 思 是 根据 名 字 进 行 自动 装 

配 ， 只 能 用 于 setter 注 入 。 比 如 我 们 有 方法 “setHelloApi”， 则 “byName" 方 式 Spring 容器 将 查找 
名 字 为 helloApi 的 Bean 并 注入 ， 如 果 找 不 到 指定 的 Bean， 将 什么 也 不 注入 。 

例如 如 下 Bean 定 义 配 置 : 


1. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
2. <bean id="bean" class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
3. autowire="byName"/> 


测试 代码 如 下 : 


package cn.javass.spring.chapter3; 

import java.io.IJOException; 

import org.junit. Test; 

import org.springframework.context.support.ClassPathXmlApplicationContext; 
import cn.javass.spring.chapter2.helloworld.HelloApi; 

public class AutowireBeanTest { 

@Test 

public void testAutowireByName() throws IOException { 


mA 一 
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ClassPathXmlApplicationContext context = 


~、 
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new ClassPathXmlApplicationContext("chapter3/autowire-byName.xml"); 


~、 
~、 


. HelloApi helloApi = context.getBean("bean", HelloApi.class); 


一 
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helloApi.sayHello(); 


} 
14. } 


~、 
ed 


是 不 是 不 要 配置 <property> 了 ， 如 果 一 个 bean 有 很 多 setter 注 入 ， 通 过 “byName” 方 式 是 不 是 
能 减少 很 多 <property> 配 置 。 此 处 注意 了 ， 在 根据 名 字 注 入 时 ， 将 把 当前 Bean 自 己 排除 在 
外 : 比如 “hello"Bean 类 定义 了 “setHello” 方 法 ， 则 hello 是 不 能 注入 到 “setHello” 的 。 


四 、“byType”: 通过 设置 Bean 定 义 属性 autowire="byType"， 意 思 是 指 根据 类 型 注入 ， 用 于 
setter 注 入 ， 比 如 如 果 指 定 自动 装配 方式 为 "byType”， 而 “setHelloApi" 方 法 需要 注入 HelloApi 类 
型 数据 ， 则 Spring 容器 将 查找 HelloApi 类 型 数据 ， 如 果 找 到 一 个 则 注入 该 Bean， 如 果 找 不 到 
将 什么 也 不 注入 ， 如 果 找到 多 个 Bean 将 优先 注入 <bean> 标 签 *primary" 属 性 为 true 的 Bean， 和 否 
则 抛 出 异常 来 表明 有 个 多 个 Bean 发 现 但 不 知道 使 用 哪个 。 让 我 们 用 例子 来 讲解 一 下 这 几 种 情 
况 吧 “。 


1) 根据 类 型 只 找到 一 个 Bean， 此 处 注意 了 ， 在 根据 类 型 注入 时 ， 将 把 当前 Bean 自 己 排除 在 
外 ， 即 如 下 配置 中 helloApi 和 bean 都 是 HelloApi 接 口 的 实现 ， 而 “bean" 通 过 类 型 进行 注 

入 “HelloApi 类 型 数据 时 自己 是 排除 在 外 的 ， 配 置 如 下 (具体 测试 请 参考 
AutowireBeanTest.testAutowireByType1 方 法 ) 


1. <bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
2. <bean id="bean" class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
3. autowire="byType"/> 


2) 根据 类 型 找到 多 个 Bean 时 ， 对 于 集合 类 型 (如 List、Set) 将 注入 所 有 匹配 的 候选 者 ， 而 
对 于 其 他 类 型 遇 到 这 种 情况 可 能 需要 使 用 “autowire-candidate” 属 性 为 false 来 让 指定 的 Bean 放 
弃 作 为 自动 装配 的 候选 者 ， 或 使 用 “primary” 属 性 为 true 来 指定 某 个 Bean 为 首选 Bean : 

2.1) 通过 设置 Bean 定 义 的 "autowire-candidate" 属 性 为 false 来 把 指定 Bean 后 自动 装配 候选 者 
中 移 除 : 


1. <bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
2.，<!-- 从 自动 装配 候选 者 中 去 除 --> 


<bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl" 
autowire-candidate="false"/> 

<bean id="bean1" class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
autowire="byType"/> 
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2.2) 通过 设置 Bean 定 义 的 “primary" 属 性 为 true 来 把 指定 自动 装配 时 候选 者 中 首选 Bean : 


<bean class="cn.javass.Spring.chapter2.helloworld.Hellolmpl"/> 

<!-- 自动 装配 候选 者 中 的 首选 Bean--> 

<bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl" primary="true"/> 
<bean id="bean" class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
autowire="byType"/> 


POD 


具体 测试 请 参考 AutowireBeanTest 类 的 testAutowireByType* 方 法 。 


五 、“constructor”: 通过 设置 Bean 定 义 属 性 autowire="constructor'， 功 能 和 “byType" 功 能 一 
样 ， 根 据 类 型 注入 构造 器 参数 ， 只 是 用 于 构造 器 注入 方式 ， 直 接 看 例子 吧 : 


<bean class="cn.javass.Spring.chapter2.helloworld.Hellolmpl"/> 

<!-- 自动 装配 候选 者 中 的 首选 Bean--> 

<bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl" primary="true"/> 
<bean id="bean" 

class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
autowire="constructor"/> 


OPP 


测试 代码 如 下 : 


@Test 

public void testAutowireByConstructor() throws IOException { 
ClassPathXmlApplicationContext context = 

new ClassPathXmlApplicationContext("chapter3/autowire-byConstructor.xml"); 
HelloApi helloApi = context.getBean("bean", HelloApi.class); 

helloApi.sayHello(); 

} 

六 、autodetect : 自动 检测 是 使 用 "constructor 还 是 “byType” 自 动 装配 方式 ， 已 不 推荐 使 用 。 
如 果 Bean 有 空 构造 器 那么 将 采用 “byType” 自 动 装配 方式 ， 否 则 使 用 "constructor" 自动 装配 方 
式 。 此 处 要 把 3.0 的 xsd 替 换 为 2.5 的 Xxsd， 和 否则 会 报错 。 


DOAN 一 


1. <?xml version="1.0" encoding="UTF-8"?> 

2. <beans xmlns="http:/www.springframework.org/schema/beans" 
3. xmlns:xsi="http:/www.w3.org/2001/XMLSchema-instance" 

4. xmlns:context="http://www.springframework.org/schema/context" 
5. xsi:schemaLocation=" 


6. http://www.springframework.org/schema/beans 

7. http://www.springframework.org/schema/beans/spring-beans-2.5.xsd 

8. http://www.springframework.org/schema/context 

9. http://www.springframework.org/schema/context/spring-context-2.5.xsd"&gt; 
10. <bean class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 

11.<!-- 自动 装配 候选 者 中 的 首选 Bean--> 

12. <bean class="cn.javass.spring.chapter2.helloworld.HellolImp!" primary="true"/> 
13. <bean id="bean" 

14. class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 

15. autowire="autodetect"/> 

16. </beans> 


可 以 采用 在 “<beans>” 标 签 中 通过 “default-autowire” 属 性 指 


定 全 局 的 自动 装配 方式 ， 即 如 果 
default-autowire="byName”， 将 对 所 有 Bean 进 行 根据 名 字 进 行 自 


动 装 配 。 
不 是 所 有 类 型 都 能 自动 装配 : 


。 不 能 自动 装配 的 数据 类 型 : Object、 基 本 数据 类 型 (Date、CharSequence、Number、 
URI、URL、Class、int) 等 ; 

。 通过 “<beans>" 标 签 default-autowire-candidates 属 性 指定 的 匹配 模式 ， 不 匹配 的 将 不 能 作 
为 自动 装配 的 候选 者 ， 例 如 指定 “Service，Dao”， 将 只 把 匹配 这 些 模 式 的 Bean 作 为 候选 
者 ， 而 不 匹配 的 不 会 作为 候选 者 ; 

。 通过 将 “<bean>” 标 签 的 autowire-candidate 属 性 可 被 设 为 false， 从 而 该 Bean 将 不 会 作为 
依赖 注入 的 候选 者 。 


数组 、 集 合 、 字 典 类 型 的 根据 类 型 自动 装配 和 普通 类 型 的 自动 装配 是 有 区 别 的 : 


。 数组 类 型 、 集 合 (Set、Collection、List) 接口 类 型 : 将 根据 泛 型 获取 匹配 的 所 有 候选 
者 并 注入 到 数组 或 集合 中 ， 如 “List<HelloApi> list" 将 选择 所 有 的 HelloApi 类 型 Bean 并 注入 
到 list 中 ， 而 对 于 集合 的 具体 类 型 将 只 选择 一 个 候选 者 ，“ 如 ArrayList<HelloApi> list 将 选 
择 一 个 类 型 为 ArrayList 的 Bean 注 入 ， 而 不 是 选择 所 有 的 HelloApi 类 型 Bean 进 行 注 入 ; 

。 字典 (Map ) 接口 类 型 : 同样 根据 泛 型 信息 注入 ， 键 必须 为 String 类 型 的 Bean 名 字 ， 值 
根据 泛 型 信息 获取 ， 如 “Map<String, HelloApi> map” 将 选择 所 有 的 HelloApi 类 型 Bean 并 
注入 到 map 中 ， 而 对 于 具体 字典 类 型 如 “HashMap<String, HelloApi> map” 将 只 选择 类 型 
为 HashMap 的 Bean 注 入 ， 而 不 是 选择 所 有 的 HelloApi 类 型 Bean 进 行 注入 。 


自动 装配 我 们 已 经 介绍 完了 ， 自 动 装配 能 带 给 我 们 什么 好 处 呢 ? 首先 ， 自 动 装配 确实 减少 了 
配置 文件 的 量 ; 其 次 ，“byType" 自 动 装配 能 在 相应 的 Bean 更 改 了 字段 类 型 时 自动 更 新 ， 即 修 
改 Bean 类 不 需要 修改 配置 ， 确 实 简单 了 。 


自动 装配 也 是 有 缺点 的 ， 最 重要 的 缺点 就 是 没有 了 配置 ， 在 查找 注入 错误 时 非常 麻烦 ， 还 有 
比如 基本 类 型 没 法 完成 自动 装配 ， 所 以 可 能 经 常 发 生 一 些 英名 其 妙 的 错误 ， 在 此 我 推荐 大 家 
不 要 使 用 该 方式 ， 最 好 是 指定 明确 的 注入 方式 ， 或 者 采用 最 新 的 Java5+ 注 解 注入 方式 。 所 以 
大 家 在 使 用 自动 装配 时 应 该 考虑 自己 负责 项 目的 复杂 度 来 进行 衡量 是 否 选 择 自动 装配 方式 。 


自动 装配 注入 方式 能 和 配置 注入 方式 一 同 工 作 吗 ? 当然 可 以 ， 大 家 只 需 记 住 配置 注入 的 数据 
会 覆盖 自动 装配 注入 的 数据 。 


注意 到 对 于 采用 自动 装配 方式 时 如 果 没 找到 合适 的 的 Bean 时 什么 也 不 做 ， 这 样 在 程 
序 中 总 会 莫名 其 妙 的 发 生 一 些 空 指针 异常 ， 而 且 是 在 程序 运行 期 间 才 能 发 现 ， 有 没有 办 法 能 
在 提前 发 现 这 些 错误 呢 ? 接 下 来 就 让 我 来 看 下 依赖 检查 吧 。 


3.3.4 依赖 检查 


上 一 节 介 绍 的 自动 装配 ， 很 可 能 发 生 没 有 匹配 的 Bean 进 行 自动 装配 ， 如 果 此 种 情况 发 生 ， 只 
有 在 程序 运行 过 程 中 发 生 了 空 指针 异常 才 色 ee 这 就 是 依 
赖 检查 的 作用 。 


Se : 用 于 检查 Bean 定 义 的 属性 都 注入 数据 了 ， 不 管 是 自动 装配 的 还 是 配置 方式 注入 的 
能 检查 ， 如 果 没 有 注入 数据 将 报错 ， 从 而 提前 发 现 注 入 错误 ， 只 检查 具有 setter 方 法 的 属 
oo 


Spring3+ 也 不 推荐 配置 方式 依赖 检查 了 ， 建 议 采 用 Java5+ @Required 注 解 方 式 ， 测 试 时 请 将 
XML schema 降 低 为 2.5 版 本 的 ， 和 自动 装配 中 “autodetect" 配 置 方式 的 xsd 一 样 。 


. <?xml version="1.0" encoding="UTF-8"?> 
. <beans xmlns="http://www.springframework.org/schema/beans" 
. xmlns:xsi="http:/www.w3.o0rg/2001/XMLSchema-instance”" 


1 

2 

3 

4. xsi:schemaLocation=" 

5. http://www.springframework.org/schema/beans 

6. http://www.springframework.org/schema/beans/spring-beans-2.5.xsd 
7 


. </beans> 
依赖 检查 有 none、simple、object、all 四 种 方式 ， 接 下 来 让 我 们 详细 介绍 一 下 : 
一 、none : 默认 方式 ， 表 示 不 检查 ; 


二 、objects : 检查 除 基 本 类 型 外 的 依赖 对 象 ， 配 置 方式 为 : dependency-check="objects" ， 
此 处 我 们 为 HelloApiDecorator 添 加 一 个 String 类 型 属性 "message”， 来 测试 如 果 有 简单 数据 类 
型 的 属性 为 null， 也 不 报错 ; 


1. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
2，<!-- 注意 我 们 没有 注入 helloApi， 所 以 测试 时 会 报错 --> 

3. <bean id="bean" 

4. class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 

5. dependency-check="objects"> 

6. <property name="message" value="Haha"/> 

7. </bean> 


注意 由 于 我 们 没有 注入 bean 需 要 的 依赖 *helloApj”， 所 以 应 该 抛 出 异常 
UnsatisfiedDependencyException， 表 示 没 有 发 现 满足 的 依赖 : 


package cn.javass.spring.chapter3; 

import java.io.IJOException; 

import org.junit. Test; 

import org.springframework.beans .factory.UnsatisfiedDependencyException.; 
import org.springframework.context.support.ClassPathXmlApplicationContext; 
public class DependencyCheckTest { 

@Test(expected = UnsatisfiedDependencyException.class) 

public void testDependencyCheckByObject() throws IOException { 

/将 抛 出 弄 常 

10. new ClassPathxXxmlApplicationContext("chapter3/dependency-check-object.xml”); 
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三 、simple : 对 基本 类 型 进行 依赖 检查 ， 包 括 数组 类 型 ， 其 他 依赖 不 报错 ; 配置 方式 为 : 
dependency-check="simple"， 以 下 配置 中 没有 注入 message 属 性 ， 所 以 会 抛 出 异常 : 


<bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
<I-- 注意 我 们 没有 注入 message 属 性 ， 所 以 测试 时 会 报错 --> 

<bean id="bean" 

class="cn.javass.spring.chapter3.bean.HelloApiDecorator" 
dependency-check="simple"> 

<property name="helloApi" ref="helloApi"/> 

</bean> 
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四 、all : 对 所 以 类 型 进行 依赖 检查 ， 配 置 方式 为 : dependency-check="all"， 如 下 配置 方式 中 
如 果 两 个 属性 其 中 一 个 没 配置 将 报错 。 


. <bean id="helloApi" class="cn.javass.spring.chapter2.helloworld.Hellolmpl"/> 
. <bean id="bean" 


. Class="cn.javass.spring.chapter3.bean.HelloApiDecorator' 


. <property name="helloApi" ref="helloApi"/> 


1 

2 

3 

4. dependency-check="all"> 

5 

6. <property name="message" value="Haha"/> 
7 


.</bean> 


依赖 检查 也 可 以 通过 “<beans>” 标 签 中 default-dependency-check 属 性 来 指定 全 局 依赖 检查 配 
置 。 


3.3.5 方法 注入 


所 谓 方法 注入 其 实 就 是 通过 配置 方式 覆盖 或 拦截 指定 的 方法 ， 通 常 通过 代理 模式 实现 。Spring 
提供 两 种 方法 注入 : 查找 方法 注入 和 方法 替换 注入 。 
因为 Spring 是 通过 CGLIB 动 态 代理 方式 实现 方法 注入 ， 也 就 是 通过 动态 修改 类 的 字 节 码 来 实现 
的 ， 本 质 就 是 生成 需 方法 注入 的 类 的 子 类 方式 实现 。 


在 进行 测试 之 前 ， 我 们 需要 确保 将 "com.springsource.cn.sf.cglib-2.2.0.jar" 放 到 lib 里 并 添加 
到 “Java Build Path” 中 的 Libararies 中 。 否 则 报错 ， 弄 常 中 包含 “nested exception is 
java.lang.NoClassDefFoundError: cn/sf/cglib/proxy/CallbackFilter” °。 


Spting 容 器 管理 方式 
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传统 方式 和 Spring 容器 管理 方式 唯一 不 同 的 是 不 需要 我 们 手动 生成 子 类 ， 而 是 通过 配置 方式 来 
实现 ; 其 中 如 果 要 替换 createPrinter() 方 法 的 返回 值 就 使 用 查找 方法 注入 ; 如 果 想 完全 替换 
sayHello() 方 法 体 就 使 用 方法 替换 注入 。 接 下 来 让 我 们 看 看 具体 实现 吧 。 


一 、 查 找 方法 注入 : 又 称 为 Lookup 方 法 注入 ， 用 于 注入 方法 返回 结果 ， 也 就 是 说 能 通过 配置 
方式 替换 方法 返回 结果 。 使 用 <lookup-method name=" 方 法 名 " bean="bean 名 字 "/> 配 置 ; 其 
中 name 属 性 指定 方法 名 ，bean 属 性 指定 方法 需 返 回 的 Bean。 


方法 定义 格式 : 访问 级 别 必须 是 public 或 protected， 保 证 能 被 子 类 重 载 ， 可 以 是 抽象 方法 ， 必 
须 有 返回 值 ， 必 须 是 无 参数 方法 ， 查 找 方 法 的 类 和 被 重 载 的 方法 必须 为 非 final : 


<public|lprotected> [abstract] <return-type> theMethodName(no-arguments); 


为 “singleton”Bean 在 容器 中 只 有 一 个 实例 ， 而 "prototype”Bean 是 每 次 获取 容器 都 返回 一 个 

全 新 的 实例 ， 所 以 如 果 “singleton?Bean 在 使 用 prototype”Bean 情 况 时 ， 那 么 prototype”Bean 
由 于 是 “singleton”"Bean 的 一 个 字段 属性 ， 所 以 获取 的 这 个 “prototype”Bean 就 和 它 所 在 

的 “singleton?Bean 具 有 同样 的 生命 周期 ， 所 以 不 是 我 们 所 期 待 的 结果 。 因 此 查找 方法 注入 就 

是 用 于 解决 这 个 问题 。 


1) 首先 定义 我 们 需要 的 类 ，Printer 类 是 一 个 有 状态 的 类 ，counter 字 段 记录 访问 次 数 : 


package cn.javass.spring.chapter3.bean; 
public class Printer { 
private int counter = 0; 


入 DD 


public void print(String type) { 


5. System.out.printin(type + " printer: " + counter++); 
6. } 
7. } 


HellolImpl5 类 用 于 打印 欢迎 信息 ， 其 中 包括 setter 注 入 和 方法 注入 ， 此 处 特别 需要 注意 的 是 该 
类 是 抽象 的 ， 充 分 说 明了 需要 容器 对 其 进行 子 类 化 处 理 ， 还 定义 了 一 个 抽象 方法 
createPrototypePrinter 用 于 创建 “prototype”Bean，createSingletonPrinter 方 法 用 于 创 

建 “singleton?Bean， 此 处 注意 方法 会 被 Spring 拦截 ， 不 会 执行 方法 体 代 码 : 


. package cn.javass.spring.chapter3; 

. import cn.javass.spring.chapter2.helloworld.HelloApi; 
. import cn.javass.spring.chapter3.bean.Printer; 

. public abstract class HellolImpl5 implements HelloApi { 
. private Printer printer; 

public void sayHello() { 

printer.print("setter"); 
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createPrototypePrinter().print("prototype"); 
9. createSingletonPrinter().print("singleton"); 
10. } 
11. public abstract Printer createPrototypePrinter(); 
12. public Printer createSingletonPrinter() { 
13. System.out.printIn(" 该 方法 不 会 被 执行 ， 如 果 输 出 就 错 了 "); 
14. return new Printer(); 
15. } 
16. public void setPrinter(Printer printer) { 
17. this.printer = printer; 
18. } 
19. } 


2) 开始 配置 了 ， 配 置 文件 在 (resources/chapter3/lookupMethodlnject.xml) ， 其 


日 日 


中 “prototypePrinter" 是 “prototype”Printer ，“singletonPrinter" 是 “singleton”Printer ，“helloApi1” 


日 i 


是 “singleton”"Bean， 而 “helloApi2” 注 入 了 “prototype”Bean : 


. <bean id="prototypePrinter" 
. Class="cn.javass.spring.chapter3.bean.Printer" scope="prototype"/> 
. <bean id="singletonPrinter" 
. Class="cn.javass.spring.chapter3.bean.Printer" scope="singleton"/> 


. <property name="printer" ref="prototypePrinter"/> 
. <lookup-method name="createPrototypePrinter" bean="prototypePrinter"/> 
. <lookup-method name="createSingletonPrinter" bean="singletonPrinter"/> 


1 
2 
3 
4 
5. <bean id="helloApi1" class="cn.javass.spring.chapter3.Hellolmpl5" scope="singleton"> 
6 
7 
8 
9. </bean> 


10. <bean id="helloApi2" class="cn.javass.Sspring.chapter3.Hellolmpl5"” scope="prototype"> 
11. <property name="printer" ref="prototypePrinter"/> 

12. <lookup-method name="createPrototypePrinter" bean="prototypePrinter"/> 

13. <lookup-method name="createSingletonPrinter" bean="singletonPrinter"/> 

14. </bean> 


3) 测试 代码 如 下 : 


. package cn.javass.spring.chapter3; 

. import org.junit. Test; 

. import org.springframework.context.support.ClassPathXmlApplicationContext; 
. import cn.javass.spring.chapter2.helloworld.HelloApi; 


1 
2 
3 
4 
5. public class MethodlnjectTest { 
6. @Test 
7. public void testLookup() { 
8. ClassPathXmlApplicationContext context = 

9. new ClassPathXmlApplicationContext("chapter3/lookupMethodlInject.xml"); 
10. System.out.printin("=======singleton sayHello======"); 

11. HelloApi helloApi1 = context.getBean("helloApi1", HelloApi.class); 
12. helloApi1.sayHello(); 
13. helloApi1 = context.getBean("helloApi1", HelloApi.class); 
14. helloApi1.sayHello(); 
15. System.out.println("=======prototype sayHello======"); 
16. HelloApi helloApi2 = context.getBean("helloApi2", HelloApi.class); 
17. helloApi2.sayHello(); 
18. helloApi2 = context.getBean("helloApi2", HelloApi.class); 
19. helloApi2.sayHello(); 
20. 从 


其 中 “helloApi1 "测试 中 ， 其 输出 结果 如 下 : 


setter printer 0 
prototype printer 0 
singleton printer 0 
setter printer: 1 
prototype printer: 0 


NO ND.: 


singleton printer: 1 


日 


首先 “helloApi1” 是 “singleton”， 通 过 setter 注 入 的 “printer" 是 “prototypePrinter”"， 所 以 它 应 该 输 
出 “setter printer:0” 和 “setter printer:1”; 而 "createPrototypePrinter 方法 注入 

了 “prototypePrinter"”， 所 以 应 该 输出 两 次 “prototype printer:0”; 而 “createSingletonPrinter” 注 
入 了 “singletonPrinter”"”， 所 以 应 该 输出 “singleton printer:0” 和 “singleton printer:1”。 


而 “helloApi2” 测 试 中 ， 其 输出 结果 如 下 : 


setter printer: 0 
prototype printer: 0 
singleton printer: 2 
setter printer: 0 
prototype printer: 0 


NO DND.: 


singleton printer: 3 


日 


首先 “helloApi2” 是 “prototype”， 通 过 setter 注 入 的 “printer" 是 “prototypePrinter”"， 所 以 它 应 该 输 

出 两 次 “setter printer:0”; 而 "createPrototypePrinter 方法 注入 了 "prototypePrinter， 所 以 应 该 

输出 两 次 “prototype printer:0”; 而 “createSingletonPrinter" 注 入 了 “singletonPrinter”， 所 以 应 该 
输出 “singleton printer:2” 和 “singleton printer:3”。 


大 家 是 否 注 意 到 “createSingletonPrinter” 方 法 应 该 输出 "该 方法 不 会 被 执行 ， 如 果 输 出 就 错 
了 ”， 而 实际 是 没 输出 的 ， 这 说 明 Spring 拦 截 了 该 方法 并 使 用 注入 的 Bean 替 换 了 返回 结果 。 


方法 注入 主要 用 于 处 理 “singleton”" 作 用 域 的 Bean 需 要 其 他 作用 域 的 Bean 时 ， 采 用 Spring 查找 
方法 注入 方式 无 需 修 改 任 何 代码 即 能 获取 需要 的 其 他 作用 域 的 Bean。 


二 、 替 换 方法 注入 : 也 叫 "MethodReplaceP 注 入 ， 和 查找 注入 方法 不 一 样 的 是 ， 他 主要 用 来 
替换 方法 体 。 通 过 首先 定义 一 个 MethodReplacer 接 口 实现 ， 然 后 如 下 配置 来 实现 : 


1. <replaced-method name=" 方 法 名 " replacer="MethodReplacer 实 现 "> 
2，<arg-type> 参 数 类 型 </arg-type> 
3. </replaced-method>” 


1) 首先 定义 MethodReplacer 实 现 ， 完 全 替换 掉 被 替换 方法 的 方法 体 及 返回 值 ， 其 中 
reimplement 方 法 重 定义 方法 功能 ， 参 数 0bj 为 被 蔡 换 方法 的 对 象 ，method 为 被 替换 方法 ， 
args 为 方法 参数 ; 最 需要 注意 的 是 不 能 再 通过 “method.invoke(obj, new String[]{"hehe"));” 反 
射 形式 再 去 调用 原来 方法 ， 这 样 会 产生 循环 调用 ; 如 果 返 回 值 类 型 为 Void， 请 在 实现 中 返回 
null : 


package cn.javass.spring.chapter3.bean; 

import java.lang.reflect.Method; 

import org.springframework.beans.factory.support.MethodReplacer; 

public class PrinterReplacer implements MethodReplacer { 

@Override 

public Object reimplement(Object obj, Method method, Object[] args) throws Throwable 
{ 

7. System.out.println("Print Replacer"); 

8. // 注 意 此 处 不 能 再 通过 反射 调用 了 ,否则 会 产生 循环 调用 ， 知 道内 存 溢出 

9. /method.invoke(obj, new String[]{"hehe"}); 
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10. return null; 
11. } 
12. } 


2) 配置 如 下 ， 首 先 定义 MethodReplacer 实 现 ， 使 用 < replaced-method > 标签 来 指定 要 进行 
替换 方法 ， 属 性 name 指 定 替换 的 方法 名 字 ，replacer 指 定 该 方法 的 重新 实现 者 ， 子 标签 < arg- 
type > 用 来 指定 原来 方法 参数 的 类 型 ， 必 须 指 定 否则 找 不 到 原 方法 : 


<bean id="replacer" class="cn.javass.spring.chapter3.bean.PrinterReplacer"/> 
<bean id="printer" class="cn.javass.spring.chapter3.bean.Printer"> 
<replaced-method name="print" replacer="replacer"> 
<arg-type>java.lang.String</arg-type> 

</replaced-method> 

</bean> 
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3) 测试 代码 将 输出 “Print Replacer ”， 说 明 方法 体 确实 被 蔡 换 了 : 


1. @Test 

2. public void testMethodReplacer() { 

3. ClassPathXmlApplicationContext context = new 
ClassPathXmlApplicationContext("chapter3/methodReplacerlnject.xm!I"); 


4. Printer printer = context.getBean("printer", Printer.class); 
5.，printer.print(" 我 将 被 蔡 换 "); 
6. } 


【第 三 章 】DI 之 3.4 Bean 的 作用 域 一 跟 我 学 
spring3 


3.4 Bean 的 作用 域 


什么 是 作用 域 呢 ? 即 “scope”， 在 面向 对 象 程序 设计 中 一 般 指 对 象 或 变量 之 间 的 可 见 范围 。 而 
在 Spring 容器 中 是 指 其 创建 的 Bean 对 象 相对 于 其 他 Bean 对 象 的 请 求 可 见 范围 。 


Spring 提 供 “singleton” 和 “prototype” 两 种 基本 作用 域 ， 另 外 提供 “request”、“session”、“global 
session” 三 种 Web 作 用 域 ; Spring 还 允许 用 户 定制 自己 的 作用 域 。 


3.4.1 基本 的 作用 域 


4 Se 指 “singleton" 作 用 域 的 Bean 只 会 在 每 个 Spring loC 容 器 中 存在 一 个 实例 ， 而 
且 其 完整 生命 周期 完全 由 Spring 容器 管理 。 对 于 所 有 获取 该 Bean 的 操作 Spring 容器 将 只 返回 
同一 个 Bean。 


GoF 单 例 设计 模式 指 "保证 一 个 类 仅 有 一 个 实例 ， 并 提供 一 个 访问 它 的 全 局 访问 点 "， 介 绍 
了 两 种 实现 : 通过 在 类 上 定义 静态 属性 保持 该 实例 和 通过 注册 表 方式 。 


1) 通过 在 类 人 属性 保持 该 实例 : 一 般 指 一 个 Java 虚 拟 机 ClassLoader 装 载 的 类 只 有 
一 个 实例 ， 一 般 通过 类 静态 属性 保持 该 实例 ， 这 样 就 造成 需要 单 例 的 类 都 需要 按照 单 例 设 计 
模式 进行 编码 ; Spring 没 采用 这 种 方式 ， 因 为 该 方式 属于 侵入 式 设计 ; 代码 样 例如 下 : 


package cn.javass.spring.chapter3.bean; 

public class Singleton { 

/1. 私 有 化 构造 器 

private Se 他 

/1/2. 单 例 缓 存 者 ， 情 性 初始 化 ， 第 一 次 使 用 时 初始 化 
private static class InstanceHolder { 

private static final Singleton INSTANCE = new Singleton(); 
} 

//3. 提 供 全 局 访问 点 

public static Singleton getlnstance() { 

. return InstanceHolderINSTANCE; 


} 
//4. 提 供 一 个 计数 器 来 验证 一 个 ClassLoader 一 个 实例 
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14. private int counter=0; 
15. } 


以 上 定义 个 了 个 单 例 类 ， 首 先 要 私有 化 类 构造 器 ; 其 次 使 用 InstanceHolder 静 态 内 部 类 持 有 单 
例 对 象 ， 这 样 可 以 得 到 情 性 初始 化 好 处 ; 最 后 提供 全 局 访问 点 getlnstance， 使 得 需要 该 单 例 
实例 的 对 象 能 获取 到 ; 我 们 在 此 还 提供 了 一 个 counter 计 数 器 来 验证 一 个 ClassLoader 一 个 实 
例 。 具 体 一 个 ClassLoader 有 一 个 单 例 实例 测试 请 参考 代码 “cn.javass.spring.chapter3. 
SingletonTest”" 中 的 “testSingleton” 测 试 方法 ， 里 边 详 细 演 示 了 一 个 ClassLoader 有 一 个 单 例 实 
例 。 





1) 通过 注册 表 方 式 : 首先 将 需要 单 例 的 实例 通过 唯一 键 注册 到 注册 表 ， 然 后 通过 键 来 获取 

单 例 ， 让 我 们 直接 看 实现 吧 ， 注 意 本 注册 表 实 现 了 Spring 接 口 “SingletonBeanRegistry”， 该 接 
口 定 义 了 操作 共享 的 单 例 对 象 ，Spring 容 器 实现 将 实现 此 接口 ; 所 以 共享 单 例 对 象 通 

过 “registerSingleton” 方 法 注册 ， 通 过 “getSingleton” 方 法 获取 ， 消 除了 编程 方式 单 例 ， 注 意 在 

实现 中 不 考虑 并 发 : 


package cn.javass.spring.chapter3; 

import java.util.Hash Map; 

import java.util.Map; 

import org.springframework.beans.factory.config.SingletonBeanRegistry; 
public class SingletonBeanRegister implements SingletonBeanRegistry { 

// 单 例 Bean 缓 存 池 ， 此 处 不 考虑 并 发 

private final Map<String, Object> BEANS = new HashMap<String, Object>(); 
public boolean containsSingleton(String beanName) { 
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return BEANS.containsKey(beanName); 

} 

. public Object getSingleton(String beanName){ 

return BEANS.get(beanName); 

} 

@Override 

public int getSingletonCount() { 

return BEANS .size(); 

} 

@Override 

public String[] getSingletonNames() { 

. return BEANS.keySet().toArray(new String[0]); 

.} 

. @Override 

public void registerSingleton(String beanName, Object bean) { 
.if(BEANS.containsKey(beanName)) { 

. throw new RuntimeException("[" + beanName + "] 已 存在 "); 


} 
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27. BEANS.put(beanName, bean); 
28. } 
29. } 


Spring 是 注册 表单 例 设计 模式 的 实现 ， 消 除了 编程 式 单 例 ， 而 且 对 代码 是 非 入 侵 式 。 
接 下 来 让 我 们 看 看 在 Spring 中 如 何 配置 单 例 Bean 吧 ， 在 Spring 容器 中 如 果 没 指定 作用 域 默认 
就 是 “singleton”， 配 置 方式 通过 scope 属 性 配置 ， 具 体 配 置 如 下 : 

1. <bean class="cn.javass.spring.chapter3.bean.Printer" scope="singleton"/> 


Spring 管理 单 例 对 象 在 Spring 容器 中 存储 如 图 3-5 所 示 ，Spring 不 仅 会 缓存 单 例 对 象 ，Bean 定 
义 也 是 会 缓存 的 ， 对 于 情 性 初始 化 的 对 象 是 在 首次 使 用 时 根据 Bean 定 义 创建 并 存放 于 单 例 组 
存 池 。 

Sping 容 兰 

Eean 定 尽 单 例 织 存 字 


将 单 例 对 象 
<bean id"beani" class=""""/> 了 放 入 缕 存 池 


<bean id'"bean2" class="" "> 


<bean i "bean3™ class="" 
lazy-init="true"> 


/Baan> 惰性 初始 化 





图 3-5 单 例 处 理 


二 、prototype : 即 原型 ， 指 每 次 向 Spring 容器 请 求 获取 Bean 都 返回 一 个 全 新 的 Bean， 相 对 
于 “singleton”" 来 说 就 是 不 缓存 Bean， 每 次 都 是 一 个 根据 Bean 定 义 创建 的 全 新 Bean 。 


GoF 原 型 设计 模式 ， 指 用 原型 实例 指定 创建 对 象 的 种 类 ， 并 且 通过 拷贝 这 些 原型 创建 新 
的 对 象 。 


Spring 中 的 原型 和 GoF 中 介绍 的 原型 含义 是 不 一 样 的 : 
GoF 通 过 用 原型 实例 指定 创建 对 象 的 种 类 ， 而 Spring 容器 用 Bean 定 义 指定 创建 对 象 的 种 类 ; 
GoF 通 过 拷贝 这 些 原 型 创建 新 的 对 象 ， 而 Spring 容器 根据 Bean 定 义 创 建新 对 象 。 


其 相同 地 方 都 是 根据 某 些 东西 创建 新 东西 ， 而 有 全 GoF 原 型 必须 显示 实现 克隆 操作 ， 属 于 侵入 
式 ， 而 Spring 容器 只 需 配置 即 可 ， 属 于 非 侵入 式 。 


接 下 来 让 我 们 看 看 Spring 如 何 实 现 原 型 呢 ? 


1) 


首先 让 我 们 来 定义 Bean“ 原 型 " : Bean 定 义 ， 所 有 对 象 将 根据 Bean 定 义 创 建 ; 在 此 我 们 只 
是 简单 示例 一 下 ， 不 会 涉及 依赖 注入 等 复杂 实现 : BeanDefinition 类 定义 属性 “class” 表 示 原 型 


类 ，"“id" 表 示 唯 一 标识 ，“scope” 表 示 作 用 域 ， 具 体 如 下 : 
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package cn.javass.spring.chapter3; 

public class BeanDefinition { 

// 单 例 

public static final int SCOPE_ SINGLETON = 0; 
// 原 型 

public static final int SCOPE_PROTOTYPE = 1; 
// 唯 一 标识 

private String id; 

//class 全 限定 名 


private String clazz; 


. // 作 用 域 


private int scope = SCOPE _SINGLETON; 
// 鉴 于 篇 幅 ， 省 略 setter 和 getter 方 法 ; 
} 


接 下 来 让 我 们 看 看 Bean 定 义 注 册 表 ， 类 似 于 单 例 注册 表 : 


package cn.javass.spring.chapter3; 

import java.util.Hash Map; 

import java.util.Map; 

public class BeanDifinitionRegister { 

//bean 定 义 缓存 ， 此 处 不 考虑 并 发 问题 

private final Map<String, BeanDefinition> DEFINITIONS = 

new HashMap<String, BeanDefinition>(); 

public void registerBeanDefinition(String beanName, BeanDefinition bd) { 
//1. 本 实现 不 允许 覆盖 Bean 定 义 

if(DEFINITIONS .containsKey(bd.getld())) { 


. throw new RuntimeException(" 已 存在 Bean 定 义 ， 此 实现 不 允许 覆盖 "); 


} 

//2. 将 Bean 定 义 放 入 Bean 定 义 缓存 池 
DEFINITIONS.put(bd.getld(), bd); 

} 

public BeanDefinition getBeanDefinition(String beanName) { 
return DEFINITIONS.get(beanName); 

} 

public boolean containsBeanDefinition(String beanName) { 
return DEFINITIONS.containsKey(beanName); 


.} 


.} 


接 下 来 应 该 来 定义 BeanFactory 了 : 


package cn.javass.spring.chapter3; 

import org.springframework.beans.factory.config.SingletonBeanRegistry; 

public class DefaultBeanFactory { 

//Bean 定 义 注册 表 

private BeanDifinitionRegister DEFINITIONS = new BeanDifinitionRegister(); 

// 单 例 注册 表 

private final SingletonBeanRegistry SINGLETONS = new SingletonBeanRegister(); 
public Object getBean(String beanName) { 


/1. 验 证 Bean 定 义 是 否 存在 
if(IDEFINITIONS.containsBeanDefinition(beanName)){ 


. throw new RuntimeException(" 不 存在 [" + beanName + "]Bean 定 义 "); 


} 

//2. 获 取 Bean 定 义 

BeanDefinition bd = DEFINITIONS.getBeanDefinition(beanName); 
//3. 是 否 该 Bean 定 义 是 单 例 作 用 域 

if(bd.getScope() == BeanDefinition.SCOPE_SINGLETON){ 

//3.1 如 果 单 例 注 册 表 包含 Bean， 则 直接 返回 该 Bean 
if(SINGLETONS.containsSingleton(beanName)) { 

return SINGLETONS.getSingleton(beanName); 


.} 
. //3.2 单 例 注册 表 不 包含 该 Bean ， 


SINGLETONS .registerSingleton(beanName, createBean(bd)); 


. return SINGLETONS.getSingleton(beanName); 

.} 

. //4. 如 果 是 原型 Bean 定 义 , 则 直接 返回 根据 Bean 定 义 创建 的 新 Bean ， 
. // 每 次 都 是 新 的 ， 无 缓存 


if(bd.getScope() == BeanDefinition.SCOPE_PROTOTYPE) { 
return createBean(bd); 


5 各 
， JW/5. 其 他 情况 错误 的 Bean 定 义 


throw new RuntimeException(" 错 误 的 Bean 定 义 "); 


} 


public void registerBeanDefinition(BeanDefinition bd) { 
DEFINITIONS.registerBeanDefinition(bd.getld(), bd); 


3. } 
4. private Object createBean(BeanDefinition bd) { 


5.// 根 据 Bean 定 义 创建 Bean 

6. try { 

7. Class clazz = Class.forName(bd.getClazz()); 

8. // 通 过 反射 使 用 无 参数 构造 器 创建 Bean 

9. return clazz.getConstructor().newlnstance(); 

10. } catch (ClassNotFoundException e)t{ 

11. throw new RuntimeException(" 没 有 找到 Bean[" + bd.getld() + "] 类 "); 
12. } catch (Exception e) { 

13. throw new RuntimeException(" 创 建 Bean[" + bd.getld() + "] 失 败 "); 
14. } 

15. } 


其 中 方法 getBean 用 于 获取 根据 beanName 对 于 的 Bean 定 义 创建 的 对 象 ， 有 单 例 和 原型 两 类 
Bean ; i ， 私有 方法 createBean 用 于 根据 Bean 
定义 中 的 类 型 信息 创建 Bean。 


3) 测试 一 下 吧 ， 在 此 我 们 只 测试 原型 作用 域 Bean， 对 于 每 次 从 Bean 工 厂 中 获取 的 Bean 都 是 
一 个 全 新 的 对 象 ， 代 码 片 段 (BeanFatoryTest) 如 下 : 


@Test 

public void testPrototype () throws Exception { 

//1. 创 建 Bean 工 厂 

DefaultBeanFactory bf = new DefaultBeanFactory(); 
//2. 创 建 原型 Bean 定 义 

BeanDefinition bd = new BeanDefinition(); 
bd.setld("bean"); 
bd.setScope(BeanDefinition.SCOPE_ PROTOTYPE); 
bd.setClazz(Hellolmpl2.class.getName!()); 
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bf.registerBeanDefinition(bd); 

. // 对 于 原型 Bean 每 次 应 该 返回 一 个 全 新 的 Bean 
System.out.printin(bf.getBean("bean") != bf.getBean("bean")); 
13. } 
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最 后 让 我 们 看 看 如 何在 Spring 中 进行 配置 吧 ， 只 需 指 定 <bean> 标 签 属 性 “scope” 属 性 
为 “prototype" 即 可 : 


1. <bean class="cn.javass.spring.chapter3.bean.Printer" scope="prototype"/> 


Spring 管理 原型 对 象 在 Spring 容器 中 存储 如 图 3-6 所 示 ，Spring 不 会 缓存 原型 对 象 ， 而 是 根据 
Bean 定 义 每 次 请 求 返 回 一 个 全 新 的 Bean : 


Spring 容 器 


<bean 1idF "beanm" clasF """ scope="singleton"/> sy 
人 
<bhean 工 上 "bean?" clasF """ scope="pmtotype"/> ey 


<bhean id "bean?" clasg """ sope="prmtotype"/> 请 


<property namE "bean?" ref="bean3"> 
<jbean> 


2 
<hean idF"bean4d" clasF """"> pF 


每 次 请 求 将 创建 一 
<hb icE "heanm5"r el > 个 全 新 的 Bean 并 返 
ean 工 ea clas 5 
pamnertby nm beand mete beama I 回 ,不 会 绎 存 
< 由 eati > 





图 3-6 原型 处 理 


单 例 和 原型 作用 域 我 们 已 经 讲 完 ， 接 下 来 让 我 们 学 习 一 些 在 Web 应 用 中 有 哪些 作用 域 : 


3.4.2 Web 应 用 中 的 作用 域 


在 Web 应 用 中 ， 我 们 可 能 需要 将 数据 存储 到 request、session 、session。 因 此 Spring 提供 了 
三 种 Web 作 用 域 : request、session 、globalSession。 


一 、request 作 用 域 : 表示 每 个 请 求 需要 容器 创建 一 个 全 新 Bean 。 比 如 提交 表单 的 数据 必须 
是 对 每 次 请 求 新 建 一 个 Bean 来 保持 这 些 表单 数据 ， 请 求 结束 释放 这 些 数 据 。 


二 、Ssession 作 用 域 : 表示 每 个 会 话 需要 容器 创建 一 个 全 新 Bean。 比如 对 于 每 个 用 户 一 般 会 
有 一 个 会 话 ， 该 用 户 的 用 户 信息 需要 存储 到 会 话 中 ， 此 时 可 以 将 该 Bean 配 置 为 web 作 用 域 。 


三 、globalSession : 类 似 于 session 作 用 域 ， 只 是 其 用 于 portlet 环 境 的 web 应 用 。 如 果 在 非 
portlet 环 境 将 视 为 session 作 用 域 。 


配置 方式 和 基本 的 作用 域 相同 ， 只 是 必须 要 有 web 环 境 支 持 ， 并 配置 相应 的 容器 监听 器 或 拦截 
器 从 而 能 应 用 这 些 作用 域 ， 我 们 会 在 集成 web 时 讲解 具体 使 用 ， 大 家 只 需要 知道 有 这 些 作用 域 
就 可 以 了 。 

3.4.4 自 定义 作用 域 

在 日 党 程序 开发 中 ， 几 乎 用 不 到 自 定义 作用 域 ， 除 非 又 必要 才 进 行 自 定义 作用 域 。 

首先 让 我 们 看 下 Scope 接 口 吧 : 


1. package org.springframework.beans.factory.config; 


import org.springframework.beans.factory.ObjectFactory; 

public interface Scope { 

Object get(String name, ObjectFactory<?> objectFactory); 

Object remove(String name); 

void registerDestructionCallback(String name, Runnable callback); 
Object resolveContextualObject(String key); 

String getConversationld(); 


} 


1) Object get(String name, ObjectFactory<?> objectFactory) : 用 于 从 作用 域 中 获取 
Bean， 其 中 参数 objectFactory 是 当 在 当前 作用 域 没 找到 合适 Bean 时 使 用 它 创建 一 个 新 的 
Bean ; 
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2) void registerDestructionCallback(String name, Runnable callback) : 用 于 注册 销毁 
回调 ， 如 果 想 要 销毁 相应 的 对 象 则 由 Spring 容器 注册 相应 的 销毁 回调 ， 而 由 自 定义 作用 域 选 择 
是 不 是 要 销毁 相应 的 对 象 ; 


3) Object resolveContextualObject(String key) : 用 于 解析 相应 的 上 下 文 数据 ， 比 如 
request 作 用 域 将 返回 request 中 的 属性 。 


4) String getConversationld() : 作用 域 的 会 话 标识 ， 比 如 session 作 用 域 将 是 sessionld。 


package cn.javass.spring.chapter3; 

import java.util.Hash Map; 

import java.util.Map; 

import org.springframework.beans.factory.ObjectFactory; 
import org.springframework.beans.factory.config.Scope; 
public class ThreadScope implements Scope { 

private final ThreadLocal<Map<String, Object>> THREAD SCOPE = 
new ThreadLocal<Map<String, Object>>() { 

protected Map<String, Object> initialValue() { 

// 用 于 存放 线程 相关 Bean 

. return new HashMap<String, Object>(); 


} 
13. } 
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让 我 们 来 实现 个 简单 的 thread 作 用 域 ， 该 作用 域内 创建 的 对 象 将 绑 定 到 ThreadLocal 内 。 


@Override 

public Object get(String name, ObjectFactory<?> objectFactory) { 
// 如 果 当 前 线程 已 经 绑 定 了 相应 Bean， 直 接 返 回 
if(THREAD_SCOPE.get().containsKey(name)) { 

return THREAD_SCOPE.get().get(name); 

} 


本 


27. 


// 使 用 objectFactory 创 建 Bean 并 绑 定 到 当前 线程 上 
THREAD SCOPE.get().put(name, objectFactory.getObject()); 
return THREAD_SCOPE.get().get(name); 


} 


. @Override 


public String getConversationld() { 

return null; 

} 

@Override 

public void registerDestructionCallback(String name, Runnable callback) { 
// 此 处 不 实现 就 代表 类 似 proytotype ， 容 器 返回 给 用 户 后 就 不 管 了 

} 

@Override 


. public Object remove(String name) { 
. return THREAD SCOPE.get().remove(name); 


.} 


@Override 


. public Object resolveContextualObject(String key) { 
. return null; 


} 
} 


Scope 已 经 实现 了 ， 让 我 们 将 其 注册 到 Spring 容器 ， 使 其 发 挥 作 用 : 


1. <bean class="org.springframework.beans.factory.config.CustomScopeConfigurer > 
2. <property name="scopes"> 

3. <map><entry> 

4. <!-- 指定 scope 关 键 字 --><key><value>thread</value></key> 

5. 
6 
7 
8 


<!-- scope 实 现 --> <bean class="cn.javass.spring.chapter3.ThreadScope"/> 


. </entry></map> 
. </property> 
.</bean> 


通过 CustomScopeConfigurer 的 scopes 属 性 注册 自 定 义 作用 域 实现 ， 在 此 需要 指定 使 用 作用 
域 的 关键 字 “thread”， 并 指定 自 定义 作用 域 实现 。 来 让 我 们 来 定义 一 个 “thread” 作 用 域 的 
Bean， 配 置 (chapter3/threadScope.xml) 如 下 : 


1. 
2 
3 


<bean id="helloApi" 
class="cn.javass.spring.chapter2.helloworld.HellolImpl" 
scope="thread"/> 


最 后 测试 (cn.javass.spring.chapter3.ThreadScopeTest) 一 下 吧 ， 首 先 在 一 个 线程 中 测试 ， 
在 同一 线程 中 获取 的 Bean 应 该 是 一 样 的 ; 再 让 我 们 开启 两 个 线程 ， 然 后 应 该 这 两 个 线程 创建 
的 Bean 是 不 一 样 : 
自 定 义 作 用 域 实现 其 实 是 非常 简单 的 ， 其 实 复杂 的 是 如 果 需 要 销毁 Bean， 自 定义 作用 域 如 何 
正确 的 销毁 Bean。 


原创 内 容 转载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/2454.html] 


【第 四 章 】 资源 之 4.1 基础 知识 一 一 跟 我 学 
spring3 


4.1.1 概述 


在 日 常 程序 开发 中 ， 处 理 外 部 资源 是 很 繁琐 的 事情 ， 我 们 可 能 需要 处 理 URL 资 源 、File 资 源 资 
源 、ClassPath 相 关 资 源 、 服 务 器 相关 资源 (JBoss AS 5.x 上 的 VFS 资 源 ) 等 等 很 多 资源 。 
此 处 理 这 些 资 源 需要 使 用 不 同 的 接口 ， 这 就 增加 了 我 们 系统 的 复杂 性 ; 而 且 处 理 这 些 资源 步 
又 都 是 类 似 的 (打开 资源 、 读 取 资 源 、 关 闭 资源 ) ， 因 此 如 果 能 抽象 出 一 个 统一 的 接口 来 对 
这 些 底层 资源 进行 统一 访问 ， 是 不 是 很 方便 ， 而 且 使 我 们 系统 更 加 简洁 ， 都 是 对 不 同 的 底层 
资源 使 用 同一 个 接口 进行 访问 。 


Spring 提供 一 个 Resource 接 口 来 统一 这 些 底 层 资 源 一 致 的 访问 ， 而 且 提 供 了 一 些 便利 的 接 
口 ， 从 而 能 提供 我 们 的 生产 力 。 


4.1.2 Resource 接 口 
Spring 的 Resource 接 口 代表 底层 外 部 资源 ， 提 供 了 对 底层 外 部 资源 的 一 致 性 访问 接口 。 


public interface InputStreamSource { 
InputStream getInputStream( ) throws IOException; 


public interface Resource extends InputStreamSource { 
boolean exists(); 
boolean isReadable(); 
boolean isOpen(); 
URL getURL() throws IOException; 
URI getURI() throws IOException; 
File getFile() throws IOException; 
long contentLength() throws IOException,; 
long lastModified() throws IOException; 
Resource createRelative(String relativePath) throws IOException; 
String getFilename(); 
String getDescription(); 


1) InputStreamSource 接 口 解析 : 


getlnputStream : 每 次 调用 都 将 返回 一 个 新 鲜 的 资源 对 应 的 java.io. InputStream 字 节 流 ， 调 
用 者 在 使 用 完毕 后 必须 关闭 该 资源 。 


2) Resource 接 口 继承 InputStreamSource 接 口 ， 并 提供 一 些 便利 方法 : 


exists : 返回 当前 Resource 代 表 的 底层 资源 是 否 存在 ，true 表 示 存 在 。 


isReadable : 返回 当前 Resource 代 表 的 底层 资源 是 否 可 读 ，true 表 示 可 读 。 


lo hon 返回 当前 Resoureef ,和 的 导 属 资源 是 否 已 经 打开 ， 如 果 返 回 true， 则 只 能 被 读 取 一 
次 然后 关闭 以 避免 资源 泄露 ; 常见 的 Resource 实 现 一 般 返 回 false。 


getURL : 如 果 当 前 Resource 代 表 的 底层 资源 能 由 java.util.URL 代 表 ， 则 返回 该 URL， 否 则 抛 
出 IOException 。 


getURI : 如 果 当 前 Resource 代 表 的 底层 资源 能 由 java.util.URI 代 表 ， 则 返回 该 URI， 和 否则 抛 出 
IOException 。 


getFile : 如 果 当 前 Resource 代 表 的 底层 资源 能 由 java.io.File 代 表 ， 则 返回 该 File， 否 则 抛 出 
IOException 。 


contentLength : 返回 当前 Resource 代 表 的 底层 文件 资源 的 长 度 ， 一 般 是 值 代表 的 文件 资源 
的 长 度 。 

lastModified : 返回 当前 Resource 代 表 的 底层 资源 的 最 后 修改 时 间 。 

createRelative : 用 于 创建 相对 于 当前 Resource 代 表 的 底层 资源 的 资源 ， 比 如 当前 Resource 


代表 文件 资源 “d:jtestj 则 createRelative (“test.txt”") 将 返回 表 文 件 资 
源 “d:/test/test.txt"?Resource 资 源 。 


getFilename : 返回 当前 Resource 代 表 的 底层 文件 资源 的 文件 路 径 ， 比 如 File 资 
源 和 fle://d:/test.txt* 将 返回 “d:/test.txt”， 而 URL 资 源 http://www.javass.cn 将 返回 ”， 因 为 只 返回 
文件 路 径 ie 


getDescription : 返回 当前 Resource 代 表 的 底层 资源 的 描述 符 ， 通 常 就 是 资源 的 全 路 径 ( 实 
际 文件 名 或 实际 URL 地 址 ) 。 


Resource 接 口 提供 了 足够 的 抽象 ， 足 够 满足 我 们 日 常 使 用 。 而 且 提 供 了 很 多 内 置 Resource 实 
现 : ByteArrayResource、lInputStreamResource 、FileSystemResource 、UrlResource 、 
ClassPathResource、ServletContextResource、VfsResource 等 。 


原创 内 容 转自 请 注 明 【http://sishuok.com/forum/blogPost/list/0/2455.html] 
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4.2 内 置 Resource 实 现 


4.2.1 ByteArrayResource 


ByteArrayResource 代 表 byte[] 数 组 资源 ， 对 于 “getInputStream" 操 作 将 返回 一 个 
ByteArrayInputStream ° 


首先 让 我 们 看 下 使 用 ByteArrayResource 如 何 处 理 byte 数 组 资源 : 


package cn.javass.spring.chapter4; 
import java.io.IOException; 
Import java.io.InputStream; 
import org.junit.Test; 
import org.springframework.core.io.ByteArrayResource; 
import org.springframework.core.io.Resource; 
public class ResourceTest { 
@Test 
public void testByteArrayResource() { 
Resource resource = new ByteArrayResource("Hello World!".getBytes()); 
if(resource.exists()) { 
dumpStream(resource); 
} 


cc 


是 不 是 很 简单 ， 让 我 们 看 下 “dumpStream” 实 现 : 


private void dumpStream(Resource resource) { 
InputStream is = null; 
try { 
//1. 获 取 文 件 资源 
is = resource.getInputStream(); 
//2. 读 取 资 源 
byte[] descBytes = new byte[is.available()]; 
is.read(descBytes); 
System.out,println(new String(descBytes)); 
} catch (IOException e) { 
e.printStackTrace(); 


} 
finally { 
try { 
//3. 关 闭 资源 
is.close(); 
} catch (IOException e) { 
} 
} 





让 我 们 来 仔细 看 一 下 代码 ，dumpStream 方 法 很 抽象 定义 了 访问 流 的 三 部 曲 : 打开 资源 、 读 取 
资源 、 关 闭 资源 ， 所 以 dunpStrean 可 以 再 进行 抽象 从 而 能 在 自己 项 目 中 使 用 ; 
byteArrayResourceTest 测 试 方法 ， 也 定义 了 基本 步骤 : 定义 资源 、 验 证 资源 存在 、 访 问 资 


ByteArrayResource 可 多 次 读 取 数 组 资源 ， 即 isOpen () 永 远 返 回 false 。 


1.2.2 InputStreamResource 


InputStreamResource 代 表 java.io.InputStream 字 节 流 ， 对 于 “getlnputStream ”操作 将 直接 返 
回 该 字 节 流 ， 因 此 只 能 读 取 一 次 该 字 节 流 ， 即 'sOpen" 永 远 返回 true 。 


让 我 们 看 下 测试 代码 吧 : 


@Test 
public void testIinputStreamResource() { 
ByteArrayInputStream bis = new ByteArrayIinputStream("Hello World!".getBytes()); 
Resource resource = new InputStreamResource(bis); 
if(resource.exists()) { 
dumpStream(resource); 


} 


Assert.assertEquals(true, resource.isOpen()); 


} 
测试 代码 几乎 和 ByteArrayResource 测 试 完全 一 样 ， 注 意 “isOpen” 此 处 用 于 返回 true。 


4.2.3 FileSystemResource 


FileSystemResource 代 表 java.io.File 资 源 ， 对 于 “getlnputStream "操作 将 返回 底层 文件 的 字 节 
流 ，“isOpen” 将 永远 返回 false， 从 而 表示 可 多 次 读 取 底层 文件 的 字 节 流 。 


让 我 们 看 下 测试 代码 吧 : 


@Test 
public void testFileResource() { 
File file = new File("d:/test.txt"); 
Resource resource = new FileSystemResource(file); 
if(resource.exists()) { 
dumpStream(resource); 
} 


Assert.assertEquals(false, resource.isOpen()); 


} 
注意 由 于 “isOpen” 将 永远 返回 false， 所 以 可 以 多 次 调用 dumpStream(resource)。 


4.2.4 ClassPathResource 


ClassPathResource 代 表 classpath 路 径 的 资源 ， 将 使 用 ClassLoader 进 行 加 载 资源 。classpath 
资源 存在 于 类 路 径 中 的 文件 系统 中 或 jar 包 里 ， 且 “isOpen" 永 远 返回 false， 表 示 可 多 次 读 取 资 


ClassPathResource 加 载 资源 替代 了 Class 类 和 ClassLoader 类 的 “name 和 "“( name)" 两 个 加 
载 类 路 径 资 源 方法 ， 提 供 一 致 的 访问 方式 。 


ClassPathResource 提 供 了 三 个 构造 器 : 
public ClassPathResource(String path) : 使 用 默认 的 ClassLoader 加 载 “path” 类 路 径 资 源 ; 


public ClassPathResource(String path, ClassLoader classLoader) : 使 用 指定 的 
ClassLoader 加 载 “path”" 类 路 径 资 源 ; 


比如 当前 类 路 径 是 “cn.javass.spring.chapter4.ResourceTest”， 而 需要 加 载 的 资源 路 径 
是 “cn/javass/spring/chapter4/test1.properties”"， 则 将 加 载 的 资源 
在 “cn/javass/spring/chapter4/test1.properties”; 


public ClassPathResource(String path, Class<?> clazz) : 使 用 指定 的 类 加 载 “path" 类 路 径 
资源 ， 将 加 载 相 对 于 当前 类 的 路 径 的 资源 ; 


比如 当前 类 路 径 是 “cn.javass.spring.chapter4.ResourceTest”， 而 需要 加 载 的 资源 路 径 
是 “cn/javass/spring/chapter4/test1.properties”， 则 将 加 载 的 资源 
在 “cn/javass/spring/chapter4/cn/javass/spring/chapter4/test1.properties” ; 


而 如 果 需 要 加 载 的 资源 路 径 为 "test1.properties”， 将 加 载 的 资源 
为 "cmjavass/spring/chapter4/test1.properties”。 


让 我 们 直接 看 测试 代码 吧 : 
1) 使 用 默认 的 加 载 器 加 载 资源 ， 将 加 载 当前 ClassLoader 类 路 径 上 相对 于 根 路 径 的 资源 : 


@Test 
public void testClasspathResourceByDefaultClassLoader() throws IOException { 
Resource resource = new ClassPathResource("cn/javass/spring/chapter4/test1.properties" 
if(resource.exists()) { 
dumpStream(resource); 
} 


System.out.println("path:" + resource.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource.isOpen()); 





2) 使 用 指定 的 ClassLoader 进 行 加 载 资 源 ， 将 加 载 指定 的 ClassLoader 类 路 径 上 相对 于 根 路 径 
的 资源 : 


@Test 
public void testClasspathResourceByClassLoader() throws IOException { 
ClassLoader cl = this.getcCclass().getclassLoader(); 
Resource resource = new ClassPathResource("cn/javass/spring/chapter4/test1.properties 
if(resource.exists()) { 
dumpStream(resource); 
} 


System.out.println("path:" + resource.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource.isOpen()); 


} 
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3) 使 用 指定 的 类 进行 加 载 资源 ， 将 尝试 加 载 相 对 于 当前 类 的 路 径 的 资源 : 


@Test 
public void testClasspathResourceByClass() throws IOException { 
Class clazz = this.getClass(); 
Resource resource1 = new ClassPathResource("cn/javass/spring/chapter4/test1.propertie 
if(resourcei.exists()) { 
dumpStream(resource1); 
} 


System.out.println("path:" + resource1.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource1.isOpen()); 


Resource resource2 = new ClassPathResource("test1.properties" , this.getclass()); 
if(resource2.exists()) { 

dumpStream(resource2); 
} 


System.out.println("path:" + resource2.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource2.isOpen()); 


} 
图 下 本 





“resource1” 将 加 载 cn/javass/spring/chapter4/cn/javass/spring/chapter4/test1.properties 资 
源 ; “resource2” 将 加 载 “cn/javass/spring/chapter4/test1.properties”; 


4) 加 载 jar 包 里 的 资源 ， 首 先 在 当前 类 路 径 下 找 不 到 ， 最 后 才 到 Jar 包 里 找 ， 而且 在 第 一 个 Jar 
包 里 找到 的 将 被 返回 : 


@Test 
public void classpathResourceTestFromJar() throws IOException { 
Resource resource = new ClassPathResource("overview.html"); 
if(resource.exists()) { 
dumpStream(resource); 
} 


System.out.println("path:" + resource.getURL().getPath()); 
Assert.assertEquals(false, resource.isOpen()); 


如 果 当 前 类 路 径 包 含 “overview.html”*， 在 项 目的 “resources” 目 录 下 ， 将 加 载 该 资源 ， 否 则 将 加 
载 Jar 包 里 的 “overview.html”， 而 且 不 能 使 用 “resource.getFile()”， 应 该 使 

用 “resource.getURL()”， 因 为 资源 不 存在 于 文件 系统 而 是 存在 于 jar 包 里 ，URL 类 似 

于 "file:/C:/.../*.jarl/overview.html” ° 


类 路 径 一 般 都 是 相对 路 径 ， 即 相对 于 类 路 径 或 相对 于 当前 类 的 路 径 ， 因 此 如 果 使 
用 “/test1.properties” 带 前 级 “的 路 径 ， 将 自动 删除 “得 到 “test1.properties”。 


4.2.5 UrIResource 


UrlIResource 代 表 URL 资 源 ， 用 于 简化 URL 资 源 访问 。"isOpen" 永 远 返回 false， 表 示 可 多 次 读 
取 资 源 。 


UrIResource 一 般 支 持 如 下 资源 访问 : 

http : 通过 标准 的 http 协 议 访 问 web 资 源 ， 如 new UrlResource("http:// 地 址 ”) ; 

ftp : 通过 ftp 协 议 访问 资源 ， 如 new UrlIResource('ftp:/ 地 址 ”) ; 

file : 通过 file 协 议 访 问 本 地 文件 系统 资源 ， 如 new UrlResource("file:d:/test.txt”) ; 
具体 使 用 方法 在 此 就 不 演示 了 ， 可 以 参考 cn.javass.spring.chapter4.ResourceTest 中 


urIResourceTest 测 试 方法 。 


4.2.6 ServletContextResource 


ServletContextResource 代 表 web 应 用 资源 ， 用 于 简化 servlet 容器 的 ServletContext 接 口 的 
getResource 操 作 和 getResourceAsStream 操 作 ; 在 此 就 不 具体 演示 了 。 


4.2.7 VfSResource 


VfSResource 代 表 Jboss 虚拟 文件 系统 资源 。 


Jboss VFS(Virtual File System) 框 架 是 一 个 文件 系统 资源 访问 的 抽象 层 ， 它 能 一 致 的 访问 物理 
文件 系统 、jar 资 源 、zip 资 源 、war 资 源 等 ，VFS 能 把 这 些 资源 一 致 的 映射 到 一 个 目录 上 ， 访 
问 它们 就 像 访 问 物理 文件 资源 一 样 ， 而 其 实 这 些 资源 不 存在 于 物理 文件 系统 。 


在 示例 之 前 需要 准备 一 些 jar 包 ， 在 此 我 们 使 用 的 是 Jboss VFS3 版 本 ， 可 以 下 载 最 新 的 Jboss 
AS 6x， 拷 贝 lib 目 录 下 的 “jboss-logging.jar" 和 “jboss-vfs.jar” 两 个 jar 包 拷贝 到 我 们 项 目的 |ib 目 录 
中 并 添加 到 “Java Build Path” 中 的 “Libaries” 中 。 


让 我 们 看 下 示例 (cn.javass.spring.chapter4.ResourceTest) 


@Test 
public void testVfsResourceForRealFileSystem() throws IOException { 
//1. 创 建 一 个 虚拟 的 文件 目录 
VirtualFile home = VFS.getCchild("/home"); 
//2. 将 虚拟 目录 映射 到 物理 的 目录 
VFS.mount(home, new RealFileSystem(new File("d:"))); 
//3. 通 过 虚拟 目录 获取 文件 资源 
VirtualFile testFile = home.getcChild("test.txt"); 
//4. 通 过 一 致 的 接口 访问 
Resource resource = new VfsResource(testrFile); 
if(resource.exists()) { 

dumpStream(resource); 
} 


System.out.printlin("path:" + resource.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource.isOpen()); 
} 
@Test 
public void testVfsResourceForJar() throws IOException { 
//1. 首 先 获 取 jar 包 路 径 
File realFile = new File("lib/org.springframework.beans-3.0.5.RELEASE.jar"); 
//2. 创 建 一 个 虚拟 的 文件 目录 
VirtualFile home = VFS.getchild("/home2"); 
//3. 将 虚拟 目录 映射 到 物理 的 目录 
VFS.mountZipExpanded(realFile, home, 
TempFileProvider.create("tmp", Executors.newSscheduledThreadPool1(1))); 
//4. 通 过 虚拟 目录 获取 文件 资源 
VirtualFile testFile = home.getchild("META-INF/spring.handlers"); 
Resource resource = new VfsResource(testFile); 
if(resource.exists()) { 
dumpStream(resource); 
} 


System.out.println("path:" + resource.getFile().getAbsolutePath()); 
Assert.assertEquals(false, resource.isOpen()); 


通过 VFS， 对 于 jar 里 的 资源 和 物理 文件 系统 访问 都 具有 一 致 性 ， 此 处 只 是 简单 示例 ， 如 果 需 
要 请 到 Jboss 官 网 深入 学 习 。 


原创 内 容 转自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2456.html] 
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4.3.1 ResourceLoader 接 口 


ResourceLoader 接 口 用 于 返回 Resource 对 象 ; 其 实现 可 以 看 作 是 一 个 生产 Resource 的 工厂 


类 。 


public interface ResourceLoader { 
Resource getResource(String location); 
ClassLoader getClassLoader(); 


getResource 接 口 用 于 根据 提供 的 location 参 数 返回 相应 的 Resource 对 象 ; 而 getClassLoader 
则 返回 加 载 这 些 Resource 的 ClassLoader。 


Spring 提供 了 一 个 适用 于 所 有 环境 的 DefaultResourceLoader 实 现 ， 可 以 返 
ClassPathResource、UrlResource ; 还 提供 一 个 用 于 web 环 境 的 
ServletContextResourceLoader， 它 继承 了 DefaultResourceLoader 的 所 有 功能 ， 又 额外 提供 
了 获取 ServletContextResource 的 支持 。 


ResourceLoader 在 进行 加 载 资源 时 需要 使 用 前 组 来 指定 需要 加 载 : “classpath:path” 表 示 返 回 
ClasspathResource ，“http:Wpath” 和 "file:path” 表 示 返 回 UrIResource 资 源 ， 如 果 不 加 前 缓 则 需 
要 根据 当前 上 下 文 来 决定 ，DefaultResourceLoader 默 认 实 现 可 以 加 载 classpath 资 源 ， 如 代码 
所 示 (cn.javass.spring.chapter4.ResourceLoaderTest) 


@Test 
public void testResourceLoad() { 
ResourceLoader loader = new DefaultResourceLoader(); 
Resource resource = loader.getResource("classpath:cn/javass/spring/chapter4/test1.txt 
// 验 证 返回 的 是 ClassPathResource 
Assert.assertEquals(ClassPathResource.class, resource.getclass()); 
Resource resource2 = loader .getResource("file:cn/javass/spring/chapter4/test1.txt"); 
// 验 证 返 回 的 是 ClasspathResource 
Assert.assertEquals(UrlResource.class, resource2.getclass()); 
Resource resource3 = loader.getResource("cn/javass/spring/chapter4/test1.txt"); 
// 验 证 返 默 认可 以 加 载 ClasspathResource 
Assert.assertTrue(resource3 instanceof ClassPathResource); 





对 于 目前 所 有 ApplicationContext 都 实现 了 ResourceLoader， 因 此 可 以 使 用 其 来 加 载 资源 。 


ClassPathXmlApplicationContext : 不 指定 前 级 将 返回 默认 的 ClassPathResource 资 源 ， 
则 将 根据 前 组 来 加 载 资 源 ; 


FileSystemXmlApplicationContext : 不 指定 前 级 将 返回 FileSystemResource， 否 则 将 根据 
前 级 来 加 载 资 源 ; 


WebApplicationContext : 不 指定 前 级 将 返回 ServletContextResource， 否 则 将 根据 前 级 来 
加 载 资源 ; 


其 他 : 不 指定 前 组 根据 当前 上 下 文 返 回 Resource 实 现 ， 否 则 将 根据 前 组 来 加 载 资 源 。 


4.3.2 ResourceLoaderAware 接 口 


ResourceLoaderAware 是 一 个 标记 接口 ， 用 于 通过 ApplicationContext 上 下 文 注入 
ResourceLoader ° 


public interface ResourceLoaderAware { 
void setResourceLoader(ResourceLoader resourceLoader ) ; 


让 我 们 看 下 测试 代码 吧 : 


1) 首先 准备 测试 Bean， 我 们 的 测试 Bean 还 简单 只 需 实 现 ResourceLoaderAware 接 口 ， 然 后 
通过 回调 将 ResourceLoader 保 存 下 来 就 可 以 了 : 


package cn.javass.spring.chapter4.bean; 
Import org.springframework.context.ResourceLoaderAware; 
Import org.springframework.core.io.ResourceLoader; 
public class ResourceBean implements ResourceLoaderAware { 
private ResourceLoader resourceLoader; 
Q@Override 
public void setResourceLoader(ResourceLoader resourceLoader) { 
this.resourceLoader = resourceLoader; 


public ResourceLoader getResourceLoader() { 
return resourceLoader; 
} 


2) 配置 Bean 定 义 (chapter4/resourceLoaderAware.xml) 


&lt;bean class="cn.javass.spring.chapter4.bean.ResourceBean"/&gt; 


3) 测试 (cn.javass.spring.chapter4.ResoureLoaderAwareTest) : 


@Test 
public void test() { 
ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter4/resourceLoaderA 
ResourceBean resourceBean = ctx.getBean(ResourceBean.class); 
ResourceLoader loader = resourceBean.getResourceLoader(); 
Assert.assertTrue(loader instanceof ApplicationContext); 











注意 此 处 “loader instanceof ApplicationContext”， 说 明了 ApplicationContext 就 是 个 
ResoureLoader ° 


由 于 上 述 实现 回调 接口 注入 ResourceLoader 的 方式 属于 侵入 式 ， 所 以 不 推荐 上 述 方法 ， 可 以 
采用 更 好 的 自动 注入 方式 ， 如 “byType” 和 "constructor， 此 处 就 不 演示 了 。 


4.3.3 注入 Resource 


通过 回调 或 注入 方式 注入 "ResourceLoader'， 然 后 再 通过 “ResourceLoader 再 来 加 载 需要 的 
资源 对 于 只 需要 加 载 茶 个 固定 的 资源 是 不 是 很 麻烦 ， 有 没有 更 好 的 方法 类 似 于 前 边 实例 中 注 
入 “java.io.File” 类 似 方式 呢 ? 


Spring 提 供 了 一 个 PropertyEditor “ResourceEditor" 用 于 在 注入 的 字符 串 和 Resource 之 间 进 
转换 。 因 此 可 以 使 用 注入 方式 注入 Resource 。 


ResourceEditor 完 全 使 用 ApplicationContext 根 据 注 入 的 路 径 字 符 串 获取 相应 的 Resource， 说 
白 了 还 是 自己 做 还 是 容器 帮 你 做 的 问题 。 


接 下 让 我 们 看 下 示例 
1) 准备 Bean : 


package cn.javass.spring.chapter4.bean; 
import org.springframework.core.io.Resource; 
public class ResourceBean3 { 
private Resource resource,; 
public Resource getResource() { 
return resource; 


public void setResource(Resource resource) { 
this.resource = resource; 


2) 准备 配置 文件 (chapter4/ resourcelnject.xml) 


&lt;bean id="resourceBeani" class="cn.javass.spring.chapter4.bean.ResourceBean3"&gt; 
&lt;property name="resource" value="cn/javass/spring/chapter4/test1.properties"/&gt,; 

&lt;/beanggt; 

&lt;bean id="resourceBean2" class="cn.javass.spring.chapter4.bean.ResourceBean3"&gt; 

&lt;property name="resource" 

value="classpath:cn/javass/spring/chapter4/test1.properties"/&gt,; 

&1lt;/beanggt; 


| 


注意 此 处 "resourceBean1" 注 入 的 路 径 没 有 前 组 表示 根据 使 用 的 ApplicationContext 实 现 进行 选 
择 Resource 实 现 。 


3) 让 我 们 来 看 下 测试 代码 (cn.javass.spring.chapter4.ResourcelnjectTest) 吧 : 


@Test 
public void test() { 


ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter4/resourceInject. 
ResourceBean3 resourceBean1 = ctx.getBean("resourceBeani", ResourceBean3.class); 
ResourceBean3 resourceBean2 = ctx.getBean("resourceBean2", ResourceBean3.class); 
Assert.assertTrue(resourceBeani.getResource() instanceof ClassPathResource); 
Assert.assertTrue(resourceBean2.getResource() instanceof ClassPathResource); 


图 








接 下 来 一 节 让 我 们 深入 ApplicationContext 对 各 种 Resource 的 支持 ， 及 如 何 使 用 更 便利 的 资源 
加 载 方式 。 


原创 内 容 转自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2457.html] 


【第 四 章 】 资源 之 4.4 Resource 通 配 符 路 径 一 
跟 我 学 spring3 


4.4.1 使 用 路 径 通配符 加 载 Resource 


前 面 介 绍 的 资源 路 径 都 是 非常 简单 的 一 个 路 径 匹配 一 个 资源 ，Spring 还 提供 了 一 种 更 强大 的 
Ant 模 式 通配符 匹配 ， 从 能 一 个 路 径 匹 配 一 批 资 源 。 


Ant 路 径 通配符 支持 $?”、“”、“*”， 注意 通 配 符 匹 配 不 包括 目录 分 隔 符 “/”: 
“3”; 匹配 一 个 字符 ， 如 “config?.xml" 将 匹配 “config1.xml ; 


‘ox; 匹配 零 个 或 多 个 字符 串 ， 如 "cnWcon1jig.xm/" 将 匹配 %mavassconfjg.xm1j， 但 不 匹配 匹 
配 “Cn/config.xm/”; 而 “mconfjg-.xml" 将 匹配 "cn/config-dao.xml” ; 


‘9 ; 匹配 路 径 中 的 零 个 或 多 个 目录 ， 如 “cnWconfig.xml" 将 匹配 “cn /config.xml”， 也 匹 
配 “cm/javass/spring/config.xml”; 而 “cn/javass/config-.xml” 将 匹配 “cn/javass/config- 
dao.xml”， 即 把 "当做 两 个 “处理 。 


Spring 提供 AntPathMatcher 来 进行 Ant 风 格 的 路 径 匹 配 。 具 体 测 试 请 参考 
cn.javass.spring.chapter4. AntPathMatcherTest 。 


Spring 在 加 载 类 路 径 资 源 时 除了 提供 前 级 “classpath:” 的 来 支持 加 载 一 个 Resource， 还 提供 一 
个 前 级 “classpath*:" 来 支持 加 载 所 有 匹配 的 类 路 径 Resource 。 


Spring 提 供 ResourcePatternResolver 接 口 来 加 载 多 个 Resource， 该 接口 继承 了 
ResourceLoader 并 添加 了 “Resource[] getResources(String locationPattern)”" 用 来 加 载 多 个 
Resource : 


1. public interface ResourcePatternResolver extends ResourceLoader { 
2. String CLASSPATH_ALL_URL_PREFIX = "classpath*:"; 

3. Resourcel[] getResources(String locationPattern) throws IOException; 
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.} 


Spring 提 供 了 一 个 ResourcePatternResolver 实 现 PathMatchingResourcePatternResolver， 它 
是 基于 模式 匹配 的 ， 默 认 使 用 AntPathMatcher 进 行路 径 匹 配 ， 它 除了 支持 ResourceLoader 支 
持 的 前 级 外 ， 还 额外 支持 “classpath:” 用 于 加 载 所 有 匹配 的 类 路 径 Resource，ResourceLoader 
不 支持 前 缓 “Classpath:”: 


首先 做 下 准备 工作 ， 在 项 目的 “resources” 创 建 “META-INF” 目 录 ， 然 后 在 其 下 创建 一 
个 "INDEX.LIST" 文 件 。 同 时 在 “org.springframework.beans- 
3.0.5.RELEASE.jar" 和 “org.springframework.context-3.0.5.RELEASE.jar" 两 个 jar 包 里 也 存在 


相同 目录 和 文件 。 然 后 创建 一 个 “LICENSE" 文 件 ， 该 文件 存在 
于 “com.springsource.cn.sf.cglib-2.2.0.jar" 里 。 


一 、“classpath”: 用 于 加 载 类 路 径 (包括 jar 包 ) 中 的 一 个 且 仅 一 个 资源 ; 对 于 多 个 匹配 的 
也 只 返回 一 个 ， 所 以 如 果 需 要 多 个 匹配 的 请 考虑 “classpath*:" 前 级 ; 


@Test 

public void testClasspathPrefix() throws IOException { 

ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); 
// 只 加 载 一 个 绝对 匹配 Resource， 且 通过 ResourceLoader.getResource 进 行 加 载 
Resource[] resources=resolver.getResources("classpath:META-INF/INDEX.LIST"); 
Assert.assertEquals(1, resources.length); 

/只 加 载 一 个 匹配 的 Resource， 且 通过 ResourceLoadergetResource 进 行 加 载 
resources = resolver.getResources("classpath:META-INF/.LIST"); 
Assert.assertTrue(resources.length == 1); 


} 


二 、“classpath*”: 用 于 加 载 类 路 径 (包括 jar 包 ) 中 的 所 有 匹配 的 资源 。 带 通配符 的 
classpath 使 用 “ClassLoader”" 的 “<> ( namey" 方 法 来 查找 通配符 之 前 的 资源 ， 然 后 通过 模式 匹 
配 来 获取 匹配 的 资源 。 ee pa META-INF/*.LIST” 将 首先 加 载 通 配 符 之 前 的 目录 “META- 
INF”， 然 后 再 遍历 路 径 进行 子路 径 匹 配 从 而 获取 匹配 的 资源 。 
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@Test 

public void testClasspathAsteriskPrefix () throws IOException { 
ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); 
// 将 加 载 多 个 绝对 匹配 的 所 有 Resource 

// 将 首先 通过 ClassLoader.getResources("META-INF") 加 载 非 模式 路 径 部 分 

// 然 后 进行 遍历 模式 匹配 

Resourcel[] resources=resolver.getResources("classpath*:META-INF/INDEX.LIST"); 
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Assert.assertTrue(resources.length > 1); 
9. // 将 加 载 多 个 模式 匹配 的 Resource 
10. resources = resolver.getResources("classpath:META-INF/.LIST"); 
11. Assert.assertTrue(resources.length > 1); 
12. } 


注意 “resources.length > 人 1 说明 返回 多 个 Resource。 不 管 模式 匹配 还 是 非 模 式 匹 配 只 要 匹配 的 
都 将 返 


在 “com.springsource.cn.sf.cglib-2.2.0.jar" 里 包含 “asm-license.txt" 文 件 ， 对 于 使 用 “classpath: 
asm-.txt" 进 行 通 配 符 方式 加 载 资源 将 什么 也 加 载 不 了 “asm-license.txt* 文 件 ， 注 意 一 定 是 模式 
路 径 匹 配 才 会 遇 到 这 种 问题 。 这 是 由 于 “ClassLoader” 的 “( name)" 方 法 的 限制 ， 对 于 name 
为 ”的 情况 将 只 返回 文件 系统 的 类 路 径 ， 不 会 包 换 jar 包 根 路 径 。 


1. @Test 


2. public void testClasspathAsteriskPrefixLimit() throws IOException { 
3. ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); /将 
首先 通过 ClassLoader.getResources("") 加 载 目录 ， 
4. // 将 只 返回 文件 系统 的 类 路 径 不 返回 jar 的 跟 路 径 
5. /然后 进行 遍历 模式 匹配 
6. Resource[] resources = resolver.getResources("classpath:asm-.txt"); 
7. Assert.assertTrue(resources.length == 0); 
8. // 将 通过 ClassLoader.getResources("asm-license.txt") 加 载 
9. /asmc-license.txt 存 在 于 com.springsource.net.sf.cglib-2.2.0Jjar 
10. resources = resolver.getResources("classpath*:asm-license .txt"); 
11. Assert.assertTrue(resources.length > 0); 
12. // 将 只 加 载 文件 系统 类 路 径 匹 配 的 Resource 
13. resources = resolver.getResources("classpath:LICENS"); 
14. Assert.assertTrue(resources.length == 1); 
15. } 


对 于 “resolver.getResources("classpath:asm-.txt");”， 由 于 在 项 目 “resources” 目 录 下 没有 所 以 
应 该 返回 0 个 资源 ; “resolver.getResources("classpath:asm-/license.txt");” 将 返回 jar 包 里 的 
Resource ; “resolver.getResources("classpath:LICENS*");”， 因 为 将 只 返回 文件 系统 类 路 径 
资源 ， 所 以 返回 1 个 资源 。 


因此 加 载 通配符 路 径 时 〈 即 路 径 中 包含 通配符 ) ， 必 须 包含 一 个 根 目录 才能 保证 加 载 的 资源 
是 所 有 的 ， 而 不 是 部 分 。 

三 、“file”: 加 载 一 个 或 多 个 文件 系统 中 的 Resource。 如 "file:D:/*.txt* 将 返回 口角 下 的 所 有 txt 文 
件 ; 

四 、 无 前 级 : 通过 ResourceLoader 实 现 加 载 一 个 资源 。 


AppliacationContext 提 供 的 getResources 方 法 将 获取 资源 委托 给 ResourcePatternResolver 实 
现 ， 默 认 使 用 PathMatchingResourcePatternResolver。 所 有 在 此 就 无 需 介 绍 其 使 用 方法 了 。 


4.4.2 注入 Resource 数 组 
Spring 还 支持 注入 Resource 数 组 ， 直 接 看 配置 如 下 : 


<bean id="resourceBean1" class="cn.javass.spring.chapter4.bean.ResourceBean4"> 
<property name="resources"> 

<array> 

<value>cn/javass/spring/chapter4/test1.properties</value> 

<value>log4j.xml</value> 

</array> 
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</property> 


8. </bean> 

9. <bean id="resourceBean2" class="cn.javass.spring.chapter4.bean.ResourceBean4"> 
10. <property name="resources" value="classpath*:META-INF/INDEX.LIST"/> 

11. </bean> 

12. <bean id="resourceBean3" class="cn.javass.spring.chapter4.bean.ResourceBean4"> 
13. <property name="resources"> 

14. <array> 

15. <value>cn/javass/spring/chapter4/test1.properties</value> 

16. <value>classpath*:META-INF/INDEX.LIST</value> 

17. </array> 

18. </property> 

19. </bean> 


“resourceBean1” 就 不 用 多 介绍 了 ， 传 统 实现 方式 ; 对 于 “resourceBean2” 则 使 用 前 
级 “classpath*”， 看 到 这 大 家 应 该 懂 的 ， 加 载 匹配 多 个 资源 ; “resourceBean3” 是 混合 使 用 的 ; 
测试 代码 在 “cn.javass.spring.chapter4.ResourcelnjectTest.testResourceArraylnject” 。 


Spring 通过 ResourceArrayPropertyEditor 来 进行 类 型 转换 的 ， 而 它 又 默认 使 

用 “PathMatchingResourcePatternResolver 来 进行 把 路 径 解 析 为 Resource 对 象 。 所 有 大 家 只 
要 会 使 用 "PathMatchingResourcePatternResolver， 其 它 一 些 实现 都 是 委托 给 它 的 ， 比 如 
AppliacationContext 的 “getResources" 方 法 等 。 


4.4.3 AppliacationContext 实 现 对 各 种 Resource 的 支持 


一 、ClassPathXmlApplicationContext : 默认 将 通过 classpath 进 行 加 载 返回 
ClassPathResource， 提 供 两 类 构造 器 方法 : 


public class ClassPathXmlApplicationContext { 

//1) 通过 ResourcePatternResolver 实 现 根据 configLocation 获 取 资 源 
public ClassPathXmlApplicationContext(String configLocation); 
public ClassPathXmlApplicationContext(String... configLocations) ; 
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public ClassPathXmlApplicationContext(String[] configLocations, ...... ); 
6. //2) 通过 直接 根据 path 直 接 返 回 ClasspathResource 


7. public ClassPathXmlApplicationContext(String path, Class clazz); 

8. public ClassPathXmlApplicationContext(String[] paths, Class clazz); 

9. public ClassPathXmlApplicationContext(String[] paths, Class clazz, ...... ); 
10. } 


第 一 类 构造 器 是 根据 提供 的 配置 文件 路 径 使 用 “ResourcePatternResolver 
”的 “getResources()" 接 口 通 过 匹配 获取 资源 ; 即 如 “classpath:config.xmb” 


第 二 类 构造 器 则 是 根据 提供 的 路 径 和 clazz 来 构造 ClassResource 资 源 。 即 采用 “public 
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ClassPathResource(String path, Class<?> clazz)" 构 造 器 获取 资源 。 


二 、FileSystemXmlApplicationContext : 将 加 载 相 对 于 当前 工作 目录 的 “configLocation” 位 
置 的 资源 ， 注 意 在 linux 系 统 上 不 管 “configLocation” 是 否 带 “*， 都 作为 相对 路 径 ; 而 在 window 
系统 上 如 “D:/resourcelnject.xml" 是 绝对 路 径 。 因 此 在 除非 很 必要 的 情况 下 ， 不 建议 使 用 该 
ApplicationContext 。 


1. public class FileSystemXmlApplicationContext{ 

2. public FileSystemXmlApplicationContext(String configLocation); 

3. public FileSystemXmlApplicationContext(String... configLocations,...... ); 
4. } 

1. Wlinux 系 统 ， 以 下 全 是 相对 于 当前 vm 路 径 进 行 加 载 

2. new FileSystemXmlApplicationContext("chapter4/config.xml"); 

3. new FileSystemXmlApplicationContext("/chapter4/confg.xml"); 


/windows 系 统 ， 第 一 个 将 相对 于 当前 vm 路 径 进行 加 载 ; 
// 第 二 个 则 是 绝对 路 径 方式 加 载 
new FileSystemxXmlApplicationContext("chapter4/config.xml”); 
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new FileSystemXmlApplicationContext("d:/chapter4/confg.xml"); 


此 处 还 需要 注意 : 在 linux 系 统 上 ， 构 造 器 使 用 的 是 相对 路 径 ， 而 ctx.getResource() 方 法 如 果 
以 oP 开 头 则 表示 获取 绝对 路 径 资源 ， 而 不 带 前 导 oj" 将 返回 相对 路 径 资源 。 如 下 : 


/linux 系 统 ， 第 一 个 将 相对 于 当前 vm 路 径 进 行 加 载 ; 

// 第 二 个 则 是 绝对 路 径 方 式 加 载 

ctx.getResource ("chapter4/config.xml"); 
ctx.getResource ("/root/confg.xml"); 

/windows 系 统 ， 第 一 个 将 相对 于 当前 vm 路 径 进行 加 载 ; 
// 第 二 个 则 是 绝对 路 径 方 式 加 载 

ctx.getResource ("chapter4/config.xml"); 
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ctx.getResource ("d:/chapter4/confg.xml); 


此 如 果 需 要 加 载 绝对 路 径 资 源 最 好 选择 前 级 "file” 方 式 ， 将 全 部 根据 绝对 路 径 加 载 。 如 在 
linux 系 统 “ctx.getResource ("file:/root/confg.xml");” 


原创 内 容 ， 转 自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2458.html] 


【第 五 章 】Spring 表 达 式 语言 之 5.1 概述 5.2 
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5.1 概述 


5.1.1 概述 


Spring 表 达 式 语言 全 称 为 “Spring Expression Language”， 缩 写 为 “SpEL”"， 类 似 于 Struts2x 中 
使 用 的 OGNL 表 达 式 语言 ， 能 在 运行 时 构建 复杂 表达 式 、 存 取 对 象 图 属性 、 对 象 方法 调用 等 
等 ， 并 且 能 与 Spring 功能 完美 整合 ， 如 能 用 来 配置 Bean 定 义 。 


表达 式 语言 给 静态 Java 语 言 增加 了 动态 功能 。 


SpEL 是 单独 模块 ， 只 依赖 于 core 模 块 ， 不 依赖 于 其 他 模块 ， 可 以 单独 使 用 。 


5.1.2 能 干什么 

表达 式 语 言 一 般 是 用 最 简单 的 形式 完成 最 主要 的 工作 ， 减 少 我 们 的 工作 量 。 
SpEL 支 持 如 下 表达 式 : 

一 、 基 本 表达 式 : 字面 量 表 达 式 、 关 系 ， 人 逻辑 与 算数 运算 表达 式 、 字 符 串 连接 及 截取 表达 

式 、 三 目 运 算 及 Elivis 表 达 式 、 正 则 表达 式 、 括 号 优先 级 表达 式 ; 

二 、 类 相关 表达 式 : 类 类 型 表达 式 、 类 实例 化 、instanceof 表 达 式 、 变 量 定 义 及 引用 、 赋 值 表 
达 式 、 自 定义 函数 、 对 象 属 性 存 取 及 安全 导航 表达 式 、 对 象 方法 调用 、Bean 引 用 ; 

三 、 集 合 相关 表达 式 : 内 联 List、 内 联 数 组 、 集 合 ， 字 典 访 问 、 列 表 ， 字 典 ， 数 组 修改 、 集 合 
受 影 、 集 合 选 择 ; 不 支持 多 维 内 联 数组 初始 化 ; 不 支持 内 联 字典 定义 ; 


< 


四 、 其 他 表达 式 : 模板 表达 式 。 
注 : SpEL 表 达 式 中 的 关键 字 是 不 区 分 大 小 写 的 。 
5.2 SpEL 基 础 


5.2.1 HelloWorld 


首先 准备 支持 SpEL 的 Jar 包 : “org.springframework.expression-3.0.5.RELEASE.jar" 将 其 添加 
到 类 路 径 中 。 


SpEL 在 求 表达 式 值 时 一 般 分 为 四 步 ， 其 中 第 三 步 可 选 : 首先 构造 一 个 解析 器 ， 其 次 解析 器 解 
析 字 符 串 表达 式 ， 在 此 构造 上 下 文 ， 最 后 根据 上 下 文 得 到 表达 式 运算 后 的 值 。 


让 我 们 看 下 代码 片段 吧 : 


package cn.javass.spring.chapters; 
Import junit.framework.Assert; 
import org.junit.Test; 
import org.springframework.expression.EvaluationContext,; 
import org.springframework.expression.Expression; 
import org.springframework.expression.ExpressionpParser; 
import org.springframework.expression.spel.standard.SpelExpressionpParser; 
import org.springframework.expression.spel.support.StandardEvaluationContext; 
public class SpELTest { 
@Test 
public void helloworld() { 
ExpressionParser parser = new SpelExpressionParser(); 
Expression expression = 
parser.parseExpression("('Hello' + ' World').concat(#end)"); 
EvaluationContext context = new StandardEvaluationContext(); 
context.setVariable("end", "!"); 
Assert.assertEquals("Hello World!", expression.getValue(context)); 


接 下 来 让 我 们 分 析 下 代码 : 


1) 创建 解析 器 : SpEL 使 用 ExpressionParser 接 口 表 示 解 析 器 ， 提 供 SpelExpressionParser 默 
认 实 现 ; 


2) 解析 表达 式 : 使 用 ExpressionParser 的 parseExpression 来 解析 相应 的 表达 式 为 Expression 
对 象 。 


3) 构造 上 下 文 : 准备 比如 变量 定义 等 等 表达 式 需 要 的 上 下 文 数据 。 
4) 求 值 : 通过 Expression 接 口 的 getValue 方 法 根据 上 下 文 获得 表达 式 值 。 


是 不 是 很 简单 ， 接 下 来 让 我 们 看 下 其 具体 实现 及 原理 吧 。 


5.2.3 SpEL 原 理 及 接口 
SpEL 提 供 简单 的 接口 从 而 简化 用 户 使 用 ， 在 介绍 原理 前 让 我 们 学 习 下 几 个 概念 : 


一 、 表 达 式 : 表达 式 是 表达 式 语言 的 核心 ， 所 以 表达 式 语言 都 是 围绕 表达 式 进 行 的 ， 从 我 们 
角度 来 看 是 “干什么 ”; 


二 、 解 析 器 : 用 于 将 字符 串 表 达 式 解析 为 表达 式 对 象 ， 从 我 们 角度 来 看 是 “ 谁 来 干 ”; 

三 、 上 下 文 : 表达 式 对 象 执行 的 环境 ， 该 环境 可 能 定义 变量 、 定 义 自 定义 函数 、 提 供 类 型 转 
换 等 等 ， 从 我 们 角度 看 是 “在 哪 干 ”; 

四 、 根 对 象 及 活动 上 下 文 对 象 : 根 对 象 是 默认 的 活动 上 下 文 对 象 ， 活 动 上 下 文 对 象 表示 了 当 
前 表达 式 操作 的 对 象 ， 从 我 们 角度 看 是 “对 谁 干 ”。 
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理解 了 这 些 概 念 后 ， 让 我 们 看 下 SpEL 如 何 工 作 的 呢 ， 如 图 5-1 所 示 : 


了 ? ExpressionParser 
Spel Expr essi onPar ser 


3、 构 造 上 下 文 对 象 


EvalumtionC ontext 





图 5-1 工作 原理 
1) 首先 定义 表达 式 :“1+2”; 
2) 定义 解析 器 ExpressionParser 实 现 ，SpEL 提 供 默 认 实 现 SpelExpressionParser ; 


2.1) SpelExpressionParser 解 析 器 内 部 使 用 Tokenizer 类 进行 词法 分 析 ， 即 把 字符 串 流 分 析 为 
记号 流 ， 记 号 在 SpEL 使 用 Token 类 来 表示 ; 


2.2) 有 了 记号 流 后 ， 解 析 器 便 可 根据 记号 流 生成 内 部 抽象 语法 树 ; 在 SpEL 中 语法 树 节 
SpelNode 接 口 实现 代表 : 如 OpPlus 表 示 加 操作 节点 、IntLiteral 表 示 int 型 字面 量 节点 ; 人 
SpelNodel 实 现 组 成 了 抽象 语法 树 ; 


2.3) 对 外 提供 Expression 接 口 来 简化 表示 抽象 语法 树 ， 从 而 隐藏 内 部 实现 细节 ， 并 提供 
getValue 简 单方 法 用 于 获取 表达 式 值 ; SpEL 提 供 默认 实现 为 SpelIExpression ; 


3) 定义 表达 式 上 下 文 对 象 (可 选 ) ，SpEL 使 用 EvaluationContext 接 口 表示 上 下 文 对 象 ， 用 
于 设置 根 对 象 、 自 定义 变量 、 自 定义 函数 、 类 型 转换 器 等 ，SpEL 提 供 默认 实现 
StandardEvaluationContext ; 


4) 使 用 表达 式 对 象 根 据 上 下 文 对 象 (可 选 ) 求 值 (调用 表达 式 对 象 的 getValue 方 法 ) 获得 结 
果 。 


接 下 来 让 我 们 看 下 SpEL 的 主要 接口 吧 : 


1) ExpressionParser 接 口 : 表示 解析 器 ， 默 认 实 现 是 
org.springframework.expression.spel.standard 包 中 的 SpelExpressionParser 类 ， 使 用 
parseExpression 方 法 将 字符 串 表 达 式 转换 为 Expression 对 象 ， 对 于 ParserContext 接 口 用 于 定 
义 字符 串 表 达 式 是 不 是 模板 ， 及 模板 开始 与 结束 字符 : 


public interface ExpressionParser { 
Expression parseExpression(String expressionSstring); 
Expression parseExpression(String expressionSstring, ParserContext context); 


来 看 下 示例 : 


@Test 
public void testParserContext() { 
ExpressionParser parser = new SpelExpressionParser(); 
ParserContext parserContext = new ParserContext() { 
@Override 
public boolean isTemplate() { 
return true; 


Q@Override 
public String getExpressionprefix() { 
return "#{"; 


@Override 
public String getExpressionSuffix() { 
return 过， 
} 
}; 


String template = "#{'Hello '}#{'World!'}"; 
Expression expression = parser.parseExpression(template, parserContext); 
Assert.assertEquals("Hello World!", expression.getValue()); 


在 此 我 们 演示 的 是 使 用 ParserContext 的 情况 ， 此 处 定义 了 ParserContext 实 现 : 定义 表达 式 是 
模块 ， 表 达 式 前 缀 为 #(”， 后 级 为“ ; 使 用 parseExpression 解 析 时 传 入 的 模板 必须 以 哄 f" 开 
头 ， 以 中 结尾 ， 如 咯 ('Hello 涛 {Worldly"。 


默认 传 入 的 字符 串 表 达 式 不 是 模板 形式 ， 如 之 前 演示 的 Hello World 。 


2) EvaluationContext 接 口 : 表示 上 下 文 环境 ， 默 认 实 现 是 
org.springframework.expression.spel.support 包 中 的 StandardEvaluationContext 类 ， 使 用 
setRootObject 方 法 来 设置 根 对 象 ， 使 用 setVariable 方 法 来 注册 自 定义 变量 ， 使 用 
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registerFunction 来 注册 自 定 义 函 数 等 等 。 


3) Expression 接 口 : 表示 表达 式 对 象 ， 黑 认 实 现 是 
org.springframework.expression.spel.standard 包 中 的 SpelExpression， 提 供 getValue 方 法 用 
于 获取 表达 式 值 ， 提 供 setValue 方 法 用 于 设置 对 象 值 。 


了 解 了 SpEL 原 理 及 接口 ， 接 下 来 的 事情 就 是 SpEL 语 法 了 。 


由 
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5.3 SpEL 坛 法 
5.3.1 基本 表达 式 


一 、 字 面 量 表 达 式 : SpEL 支 持 的 字面 量 包 括 : 字符 串 、 数 字 类 型 (int、long 、float、 
double) > 布尔 类 型 加 null 类 型 O 


示例 


党 尊 


他 String str1 = parser.parseExpression("Hello 
符 World!").getValue(String.class);String str2 = parser.parseExpression("\"Hello 
World\"").getValue(String.class); 


int int1 = parser.parseExpression("1").getValue(Integer.class);long long1 = 


数 parser.parseExpression("-1L").getValue(long.class);float float1 = 
字 parser.parseExpression("1.1").getValue(Float.class);double double1 = 
类 "1.1E+2").getValue(double.class);int hex1 = 


型 parser.parseExpression 


( 
parser.parseExpression( 
( 
parser.parseExpression( 


i 
"0xa").getValue(Integer.class);long hex2 = 
"0xaL").getValue(long.class); 


布 

尔 boolean true1 = parser.parseExpression("true").getValue(boolean.class);boolean 
类 false1 = parser.parseExpression("false").getValue(boolean.class); 

型 

null 

类 Object null1 = parser.parseExpression("null").getValue(Object.class); 

型 


二 、 算 数 运算 表达 式 : SpEL 支 持 加 (+)、 减 (-)、 乘 (*)、 除 (/)、 求 余 (%) 、 乔 (^) 运算 。 


类 型 示例 
加 减 乘 int result1 = parser.parseExpression("1+2- 
除 3*4/2").getValue(Integer.class);//-3 
求 余 int result2 = parser.parseExpression("4%3").getValue(Integer.class);//1 
寡 运 算 int result3 = parser.parseExpression("2^3").getValue(Integer.class);//8 


SpEL 还 提供 求 余 (MOD) 和 除 (DIV) 而 外 两 个 运算 符 ， 与 “%” 和 "等 价 ， 不 区 分 大 小 写 


三 、 关 系 表达 式 : 等 于 (==) 、 不 等 于 (1=)、 大 于 (>)、 大 于 等 于 (>=)、 小 于 (<)、 小 于 等 于 
(<=)， 区 间 (between) 运算 ， 

如 “parser.parseExpression("1>2").getValue(boolean.class);” 将 返回 false ; 

而 “parser.parseExpression("1 between {1, 2}").getValue(boolean.class);” 将 返回 true。 


between 运 算 符 右边 操作 数 必须 是 列表 类 型 ， 且 只 能 包含 2 个 元 素 。 第 一 个 元 素 为 开始 ， 第 二 
个 元 素 为 结束 ， 区 间 运 算是 包含 边界 值 的 ， 即 xxx>=list.get(0) && xxx<=list.get(1)。 


SpEL 同 样 提供 了 等 价 的 “EQ”、“NE”、“GT”、“GE”、“LT”、“LE” 来 表示 等 于 、 不 等 于 、 大 
于 、 大 于 等 于 、 小 于 、 小 于 等 于 ， 不 区 分 大 小 号 


四 、 逻 辑 表达 式 : 且 (and) 、 或 (or)、 非 (! 或 NOT)。 


1. String expression1 = "2>1 and (ltrue or !false)”; 

2. boolean result1 = parserparseExpression(expression1).getValue(boolean.class); 

3. Assert.assertEquals(true, result1); 

4. String expression2 = "2>1 and (NOT true or NOT false)"; 

5. boolean result2 = parser.parseExpression(expression2).getValue(boolean.class); 

6. Assert.assertEquals(true, result2); 

注 : 逻辑 运算 符 不 支持 Java 中 的 && 和 ||。 
五 、 字 符 串 连接 及 截取 表达 式 ; 使 用 +” 进行 字符 串 连 接 ， 使 用 “String'[0] [index]" 来 截取 一 个 
， 目前 只 支持 截取 一 个 ， 如 “Hello '+'World!" 得 到 “Hello Worldl”; 而 “Hello World![O] 将 
返回 “H”。 
六 、 三 目 运 算 及 Elivis 运 算 表 达 式 : 
三 目 运 算 符 “ 表 达 式 13 表 达 式 2: 表 达 式 3” 用 于 构造 三 目 运 算 表 达 式 ， 如 “2>1?true:false” 将 返 
true ; 


Elivis 运 算 符 “ 表 达 式 13: 表 达 式 2” 从 Groovy 语 言 引 入 用 于 简化 三 目 运 算 符 的 ， 当 表达 式 1 为 非 
null 时 则 返回 表达 式 1， 当 表达 式 1 为 null 时 则 返回 表达 式 2， 简 化 了 三 目 运 算 符 方式 “表达 式 1? 
表达 式 1: 表 达 式 2”， 如 “null?:false” 将 返回 false， 而 “true?:false” 将 返回 true ; 


七 、 正 则 表达 式 : 使 用 “str matches regex， 如 “123' matches "\d{3}” 将 返回 true ; 


八 、 括 号 优先 级 表达 式 : 使 用 "( 表 达 式 ) 构造 ， 括 号 里 的 具有 高 优先 级 。 
5.3.3 类 相关 表达 式 
一 、 类 类 型 表达 式 : 使 用 “T(Type)》 来 表示 java. lang. Class 实 例 ，“Type" 必 须 是 类 全 限定 


名 ，"java.lang” 包 除外 ， 即 该 包 下 的 类 可 以 不 指定 包 名 ; 使 用 类 类 型 表达 式 还 可 以 进行 访问 类 
静态 方法 及 类 静态 字段 


具体 使 用 方法 如 下 : 


@Test 

public void testClassTypeExpression() { 

ExpressionParser parser = new SpelExpressionParser(); 

/jjava.lang 包 类 访问 

Class<String> result1 = parser.parseExpression("T(String)").getValue(Class.class); 
Assert.assertEquals(String.class, result1); 

// 其 他 包 类 访问 

String expression2 = "T(cn.javass.spring.chapter5.SpELTest)”; 

Class<String> result2 = parser.parseExpression(expression2).getValue(Class.class); 
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Assert.assertEquals(SpELTest.class, result2 ); 
10. // 类 静态 字段 访问 
11. int result3=parser.parseExpression("T(Integer).MAX VALUE").getValue(int.class); 
12. Assert.assertEquals(Integer.MAX VALUE., result3); 
13. // 类 静态 方法 调用 
14. int result4 = parser.parseExpression("T(Integer).parselnt('1')").getValue(int.class); 
15. Assert.assertEquals(1, result4); 
16. } 


对 于 java.lang 包 里 的 可 以 直接 使 用 “T(String)" 访 问 ; 其 他 包 必 须 是 类 全 限定 名 ; 可 以 进行 静态 
字段 访问 如 “T(Integer).MAX_VALUE” ; 也 可 以 进行 静态 方法 访问 如 “(Integer). oe ° 


二 、 类 实例 化 : 类 实例 化 同样 使 用 java 关 键 字 “new”， 类 名 必须 是 全 限定 名 ， 但 java.lang 包 内 
和 类 型 除外 ， 如 String、Integer。 
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@Test 

public void testConstructorExpression() { 

ExpressionParser parser = new SpelExpressionParser!(); 

String result1 = parser.parseExpression("new String(haha')").getValue(String.class); 
Assert.assertEquals("haha", result1); 

Date result2 = parser.parseExpression("new java.util.Date()").getValue(Date.class); 
Assert.assertNotNull(result2); 


} 
实例 化 完全 跟 Java 内 方式 一 样 。 
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三 、instanceof 表 达 式 : SpEL 支 持 instanceof 运 算 符 ， 跟 Java 内 使 用 同 义 ; 如 “haha 
instanceof T(String)” 将 返回 true。 


四 、 变 量 定 义 及 引用 : 变量 定义 通过 EvaluationContext 接 口 的 setVariable(variableName， 
value) 方 法 定义 ; 二 用 ;除了 引用 自 定 义 变量 ，SpE 还 允许 
引用 根 对 象 及 当前 上 下 文 对 象 ， 使 用 ' 哩 root? 引 用 根 对 象 ， 使 用 只 this" 引 用 当前 上 下 文 对 象 
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@Test 

public void testVariableExpression() { 

ExpressionParser parser = new SpelExpressionParser(); 

EvaluationContext context = new StandardEvaluationContext(); 
context.setVariable("variable", "haha"); 

context.setVariable("variable", "haha"); 

String result1 = parser.parseExpression("#variable").getValue(context, String.class); 
Assert.assertEquals("haha", result1); 


context = new StandardEvaluationContext("haha"); 


String result2 = parser.parseExpression("#root").getValue(context, String.class); 


. Assert.assertEquals("haha", result2); 


String result3 = parser.parseExpression("#this").getValue(context, String.class); 
Assert.assertEquals("haha", result3); 


} 


使 用 #variable” 来 引用 在 EvaluationContext 定 义 的 变量 ; 除了 可 以 引用 自 定义 变量 ， 还 可 以 使 
用 喷 rootz 引 用 根 对 象 ，' 翌 this? 引 用 当前 上 下 文 对 象 ， 此 处 哄 this* 即 根 对 象 。 


五 、 


自 定义 函数 : 目前 只 支持 类 静态 方法 注册 为 自 定义 函数 ; SpEL 使 用 


StandardEvaluationContext 的 registerFunction 方 法 进行 注册 自 定义 函数 ， 其 实 完全 可 以 使 用 
setVariable 代 蔡 ， 两 者 其 实 本 质 是 一 样 的 ; 


1. @lTest 
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public void testFunctionExpression() throws SecurityException， 
NoSuchMethodException { 

ExpressionParser parser = new SpelExpressionParser!(); 
StandardEvaluationContext context = new StandardEvaluationContext(); 
Method parselnt = Integer.class.getDeclaredMethod("parselnt", String.class); 
context.registerF unction("parselnt", parselnt); 
context.setVariable("parselnt2", parselnt); 

String expression1 = "#parselnt('3') == #parselnt2('3")"; 

boolean result1 = parser.parseExpression(expression1).getValue(context, 
boolean.class); 

Assert.assertEquals(true, result1); 


.} 


此 处 可 以 看 出 “registerFunction”" 和 “setVariable” 都 可 以 注册 自 定义 函数 ， 但 是 两 个 方法 的 含义 
不 一 样 ， 推 荐 使 用 “registerFunction” 方 法 注册 自 定 义 函 数 。 


六 、 赋 值 表达 式 : SpEL 即 允许 给 自 定 义 变量 赋值 ， 也 允许 给 跟 对 象 赋值 ， 直 接 使 
用 “variableName=value" 即 可 赋值 : 


@Test 

public void testAssignExpression() { 

ExpressionParser parser = new SpelExpressionParser(); 

/1. 给 root 对 象 赋值 

EvaluationContext context = new StandardEvaluationContext("aaaa"); 
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String result1 = parser.parseExpression("#root='aaaaa").getValue(context, 
String.class); 

7. Assert.assertEquals("aaaaa", result1); 

8. String result2 = parser.parseExpression("#this='aaaa").getValue(context, String.class); 
9. Assert.assertEquals("aaaa", result2); 


10. //2. 给 自 定义 变量 赋值 


11. context.setVariable("#variable", "variable"); 

12. String result3 = parser.parseExpression("#variable=#root").getValue(context, 
String.class); 

13. Assert.assertEquals("aaaa", result3); 


14. } 


使 用 "#root='aaaaa'" 给 根 对 象 赋值 ， 使 用 “"##this='aaaa" 给 当前 上 下 文 对 象 赋值 ， 使 
用 “#Variable=#root" 给 自 定义 变量 赋值 ， 很 简单 。 


七 、 对 象 属性 存 取 及 安全 导航 表达 式 : 对 象 属性 获取 非常 简单 ， 即 使 用 

如 “a.property. property 这 种 点 级 式 获取 ，SpEL 对 于 属性 名 首 字母 是 不 区 分 大 小 写 的 ; SpEL 还 
引入 了 Groovy 语 言 中 a a 云 算 符 "( 对 象 | 属性 )?. 属 性 ”， 用 来 避免 但 “3." 前 边 的 表达 式 为 
null 时 抛 出 空 指针 异常 ， 返回 null ; 修改 对 象 属性 值 则 可 以 通过 赋值 表达 式 或 Expression 
接口 et o 


ExpressionParser parser = new SpelExpressionParser(); 

/1. 访 问 root 对 象 属性 

Date date = new Date (); 

StandardEvaluationContext context = new StandardEvaluationContext(date); 
int result1 = parser.parseExpression("Year").getValue(context, int.class); 
Assert.assertEquals(date.getYear(), result1); 


); 
int result2 = parser.parseExpression("year").getValue(context, int.class); 


DDN 一 


Assert.assertEdquals(date.getYear(), result2 ); 


对 于 当前 上 下 文 对 象 属性 及 方法 访问 ， 可 以 直接 使 用 属性 或 方法 名 访问 ， 比 如 此 处 根 对 象 
date 属 性 “year， 注 意 此 处 属性 名 首 字母 不 区 分 大 小 写 


/2. 安 全 访问 
context.setRootObject(null); 
Object result3 = parser.parseExpression("#root?.year").getValue(context, Object.class); 
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Assert.assertEquals(null, result3); 


SpEL 引 入 了 Groovy 的 安全 导航 运算 符 ， 比 如 此 处 根 对 象 为 null， 所 以 如 果 访 问 其 属性 时 肯定 
抛 出 空 指针 异常 ， 而 采用 “3." 安 全 访问 导航 运算 符 将 不 抛 室 指针 异常 ， 而 是 简单 的 返回 null。 
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/3. 给 root 对 象 属性 赋值 

context.setRootObject(date); 

int result4 = parser.parseExpression("Year = 4").getValue(context, int.class); 
Assert.assertEquals(4, result4); 
parser.parseExpression("Year").setValue(context, 5); 

int result5 = parser.parseExpression("Year").getValue(context, int.class); 
Assert.assertEquals(5, result5); 


给 对 象 属性 赋值 可 以 采用 赋值 表达 式 或 Expression 接 口 的 setValue 方 法 赋值 而且 也 可 以 采用 
点 组 方式 赋值 。 


八 、 对 象 方法 调用 : 对 象 方法 调用 更 简单 ， 跟 Java 语 法 一 样 ; 如 “haha'.substring(2,4)" 将 返 
回 “ha”; 而 对 于 根 对 象 可 以 直接 调用 方法 ; 
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Date date = new Date(); 

StandardEvaluationContext context = new StandardEvaluationContext(date); 
int result2 = parser.parseExpression("getYear()").getValue(context, int.class); 
Assert.assertEquals(date.getYear(), result2 ); 


比如 根 对 象 date 方 法 “getYear 可 以 直接 调用 。 


九 、 


Bean 引 用 : SpEL 支 持 使 用 “@” 符 号 来 引用 Bean， 在 引用 Bean 时 需要 使 用 BeanResolver 


接口 实现 来 查找 Bean，Spring 提 供 BeanFactoryResolver 实 现 ; 


9. 
10. 


mA 一 


@Test 

public void testBeanExpression() { 

ClassPathXmlApplicationContext ctx = new ClassPathXmlApplicationContext(); 
ctx.refresh(); 

ExpressionParser parser = new SpelExpressionParser(); 
StandardEvaluationContext context = new StandardEvaluationContext(); 
context.setBeanResolver(new BeanFactoryResolver(ctx)); 

Properties result1 = parser.parseExpression("@systemProperties").getValue(context, 
Properties.class); 

Assert.assertEquals(System.getProperties(), result1 ); 


} 


在 示例 中 我 们 首先 初始 化 了 一 个 loC 容 器 ，ClassPathXmlApplicationContext 实现 默认 会 
把 “System.getProperties()” 注 册 为 “systemProperties"Bean， 因 此 我 们 使 用 
“@systemProperties” 来 引用 该 Bean 。 


5.3.3 集合 相关 表达 式 


一 、 内 联 List : 从 Spring3.0.4 开 始 支持 内 联 List， 使 用 {表达 式 ，...... } 定 义 内 联 List ， 
如 %1,2,3} 将 返回 一 个 整 型 的 ArrayList， 而 “人 "将 返回 空 的 List， 对 于 字面 量 表达 式 列表 ，SpEL 
会 使 用 java.util.Collections.unmodifiableList 方 法 将 列表 设置 为 不 可 修改 。 
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// 将 返回 不 可 修改 的 空 List 
List<Integer> result2 = parser.parseExpression("{}").getValue(List.class); 


// 对 于 字面 量 列表 也 将 返回 不 可 修改 的 List 

List<Integer> result1 = parser.parseExpression("{1,2,3}").getValue(List.class); 
Assert.assertEquals(new Integer(1), result1.get(0)); 

try { 

result1.set(0, 2); 

// 不 可 能 执行 到 这 ， 对 于 字面 量 列表 不 可 修改 

Assert.fail(); 

} catch (Exception e){ 


} 

// 对 于 列表 中 只 要 有 一 个 不 是 字面 量 表 达 式 ， 将 只 返回 原始 List ， 

// 不 会 进行 不 可 修改 处 理 

String expression3 = "{{1+2,2+4}),{3,4+4}}"; 

List<List<Integer>> result3 = parser.parseExpression(expression3).getValue(List.class); 
result3.get(0).set(0, 1); 

Assert.assertEquals(2, result3.size()); 


/声明 一 个 大 小 为 2 的 一 维 数组 并 初始 化 
int[] result2 = parser.parseExpression("new int[21{1,2}").getValue(int[].class); 


1. /定义 一 维 数组 但 不 初始 化 


Eh 


int[] result1 = parser.parseExpression("new int[1]").getValue(int[].class); 


内 联 数 组 : 和 Java 数组 定义 类 似 ， 只 是 在 定义 时 进行 多 维 数组 初始 化 。 


1. /定义 多 维 数组 但 不 初始 化 
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int[][][] result3 = parser.parseExpression("new int[1][2][3]").getValue(int[][][].class); 


// 错 误 的 定义 多 维 数组 ， 多 维 数组 不 能 初始 化 

String expression4 = "new int[1][2][3]1{{1}H2}H3}}"; 

try { 

int[][][] result4 = parser.parseExpression(expression4).getValue(int[][][].class); 
Assert.fail(); 

} catch (Exception e){ 


} 
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、 集 合 ， 字 典 元 素 访 问 : SpEL 目 前 支持 所 有 集合 类 型 和 字典 类 型 的 元 素 访 问 ， 使 用 “集合 
[索引 ]? 访 问 集合 元 素 ， 使 用 "map[key] 访问 字典 元 素 ; 


/HSpEL 内 联 List 访 问 

int result1 = parser.parseExpression("{1,2,3}[0]").getValue(int.class); 
// 即 list.get(0) 

Assert.assertEquals(1, result1); 


//SpEL 目 前 支持 所 有 集合 类 型 的 访问 

Collection<lnteger> collection = new HashSet<lnteger>(); 

collection.add(1); 

collection.add(2); 

EvaluationContext context2 = new StandardEvaluationContext(); 
context2.setVariable("collection", collection); 

int result2 = parser.parseExpression("#collection[1]").getValue(context2, int.class); 
// 对 于 任何 集合 类 型 通过 |terator 来 定位 元 素 

Assert.assertEquals(2, result2); 


//SpEL 对 Map 字 典 元 素 访问 的 支持 

Map<String, Integer> map = new HashMap<String, Integer>(); 

map.put("a", 1); 

EvaluationContext context3 = new StandardEvaluationContext(); 
context3.setVariable("map", map); 

int result3 = parser.parseExpression(#map[a]").getValue(context3, int.class); 
Assert.assertEquals(1, result3); 


: 集合 元 素 访 问 是 通过 lterator 遍 历来 定位 元 素 位 置 


Eh 


列表 ， 字 典 ， 数 组 元 素 修改 : 可 以 使 用 赋值 表达 式 或 Expression 接 口 的 setValue 方 法 修 


//1. 修 改 数 组 元 素 值 

int[] array = new int[] {1, 2); 

EvaluationContext context1 = new StandardEvaluationContext(); 
context1.setVariable("array", array); 

int result1 = parser.parseExpression("#array[1] = 3").getValue(context1, int.class); 
Assert.assertEquals(3, result1); 


//2. 修 改 集合 值 

Collection<Integer> collection = new ArrayList<lnteger>(); 
collection.add(1); 

collection.add(2); 

EvaluationContext context2 = new StandardEvaluationContext(); 
context2.setVariable("collection", collection); 


int result2 = parser.parseExpression("#collection[1] = 3").getValue(context2, int.class); 
Assert.assert Equals(3, result2); 
parser.parseExpression("#collection[1]").setValue(context2, 4); 

result2 = parser.parseExpression("#collection[1]").getValue(context2, int.class); 


. Assert.assertEquals(4, result2); 


/3. 修 改 map 元 素 值 

Map<String, Integer> map = new HashMap<String, Integer>(); 

map.put("a", 1); 

EvaluationContext context3 = new StandardEvaluationContext(); 
context3.setVariable("map", map); 

int result3 = parser.parseExpression(#map[a] = 2").getValue(context3, int.class); 


Assert.assertEquals(2, result3); 


对 数组 修改 直接 对 “#array[index]" 赋 值 即 可 修改 元 素 值 ， 同 理 适 用 于 集合 和 字典 类 型 。 


五 、 


集合 投影 : 在 SQL 中 投影 指 从 表 中 选择 出 列 ， 而 在 SpEL 指 根据 集合 中 的 元 素 中 通过 选择 


来 构造 另 一 个 集合 ， 该 集合 和 原 集合 具有 相同 数量 的 元 素 ; SpEL 使 用 “(listlmap) .![ 投 影 表 
达 式 ]" 来 进行 投影 运算 : 


OPP 
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/1. 首 先 准备 测试 数据 

Collection<Integer> collection = new ArrayList<lnteger>(); 
collection.add(4); collection.add(5); 

Map<String, Integer> map = new HashMap<String, Integer>(); 
map.put("a", 1); map.put("b", 2); 


//2. 测 试 集合 或 数组 

EvaluationContext context1 = new StandardEvaluationContext(); 
context1.setVariable("collection", collection); 

Collection<lnteger> result1 = 
parser.parseExpression("#collection.![#this+1]").getValue(context1, Collection.class); 
Assert.assertEquals(2, result1.size()); 

Assert.assertEquals(new Integer(5), result1 .iterator().next()); 


对 于 集合 或 数组 使 用 如 上 表达 式 进行 投影 运算 ， 其 中 投影 表达 式 中 做 this”" 代 表 每 个 集合 或 数组 
元 素 ， 可 以 使 用 上 比如“#this.property" 来 获取 集合 元 素 的 属性 ， 其 中 “#this”" 可 以 省 略 。 


OroDPD= 


//3. 测 试 字典 

EvaluationContext context2 = new StandardEvaluationContext(); 
context2.setVariable("map", map); 

List<Integer> result2 = 

parser.parseExpression("#map.![ value+1]").getValue(context2, List.class); 
Assert.assert Equals(2, result2.size()); 


SpEL 投 影 运算 还 支持 Map 投 影 ， 但 Map 投 影 最 终 只 能 得 到 List 结 果 ， 如 上 所 示 ， 对 于 投影 表达 
式 中 的 “大 his” 将 是 Map.Entry， 所 以 可 以 使 用 “value” 来 获取 值 ， 使 用 “key” 来 获取 键 。 


六 、 集 合 选 择 : 在 SQL 中 指使 用 select 进 行 选择 行 数据 ， 而 在 SpEL 指 根据 原 集合 通过 条 件 表 

达 式 选择 出 满足 条 件 的 元 素 并 构造 为 新 的 集合 ，SpEL 使 用 "listlmap).?[ 选 择 表达 式 ]”， 其 中 选 
择 表达 式 结果 必须 是 boolean 类 型 ， 如 果 true 则 选择 的 元 素 将 添加 到 新 集合 中 ，false 将 不 添加 
到 新 集合 中 。 


/1. 首 先 准 备 测试 数据 

Collection<lnteger> collection = new ArrayList<lnteger>(); 
collection.add(4); collection.add(5); 

Map<String, Integer> map = new HashMap<String, Integer>(); 
map.put("a", 1); map.put("b", 2); 
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//2. 集 合 或 数组 测试 

EvaluationContext context1 = new StandardEvaluationContext(); 
context1.setVariable("collection", collection); 

Collection<lnteger> result1 = 
parser.parseExpression("#collection.?[#this>4]").getValue(context1, Collection.class); 
Assert.assertEquals(1, result1.size()); 
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Assert.assertEdquals(new Integer(5), result1.iterator().next()); 


对 于 集合 或 数组 选择 ， 如 做 collection.?[#this>4 了 将 选择 出 集合 元 素 值 大 于 4 的 所 有 元 素 。 选 择 
表达 式 必须 返回 布尔 类 型 ， 使 用 “#this" 表 示 当 前 元 素 。 


//3. 字 典 测试 

EvaluationContext context2 = new StandardEvaluationContext(); 
context2.setVariable("map", map); 

Map<String, Integer> result2 = 

parser.parseExpression("#map.?[#this.key != 'a']").getValue(context2, Map.class); 
Assert.assert Equals(1, result2.size()); 
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7. List<Integer> result3 = 


8. parser.parseExpression("#map.?[key != 'a'].![value+1]").getValue(context2, List.class); 
9. Assert.assertEquals(new Integer(3), result3.iterator().next()); 


对 于 字典 选择 ， 如 人 叶 map.?[ 夫 his.key != 'a 了 将 选择 键 值 不 等 于 "a” 的 ， 其 中 选择 表达 式 

中 “#this”" 是 Map.Entry 类 型 ， 而 最 终结 果 还 是 Map， 这 点 和 投影 不 同 ; 集合 选择 和 投影 可 以 一 
起 使 用 ， 如 #map.?[key != 'a].![value+1]" 将 首先 选择 键 值 不 等 于 "a" 的 ， 然 后 在 选 出 的 Map 中 
再 进行 “value+ 人 的 投影 。 


5.3.4 表达 式 模 板 


模板 表达 式 就 是 由 字面 量 与 一 个 或 多 个 表达 式 块 组 成 。 每 个 表达 式 块 由 "前 组 + 表达 式 + 后 组 " 形 
式 组 成 ， 如 *${1+2? 即 表达 式 块 。 在 前 边 我 们 已 经 介绍 了 使 用 ParserContext 接 口 实现 来 定义 
表达 式 是 否 是 模板 及 前 级 和 后 组 定义 。 在 此 就 不 多 介绍 了 ， 如 "Error ${#v0} ${#v1? 表 达 式 表 
示 由 字面 量 "Error ”、 模 板 表达 式 坦 v0"、 模 板 表达 式 只 v1" 组 成 ， 其 中 v0 和 V1 表 示 自 定义 变量 ， 
需要 在 上 下 文 定 义 。 


原创 内 容 转自 请 注 明 私 整 在 线 【http://sishuok.com/forum/blogPost/list/0/2463.htmlj 


【第 五 章 】Spring 表 达 式 语言 之 5.4 在 Bean 定 义 中 
使 用 EL 一 跟 我 学 Spring3 


5.4.1 xml 风 格 的 配置 


SpEL 支 持 在 Bean 定 义 时 注入 ， 默 认 使 用 “#{SpEL 表 达 式 )” 表 示 ， 其 中 做 Foot" 根 对 象 默 认可 以 
认为 是 ApplicationContext， 只 有 ApplicationContext 实 现 默 认 支 持 SpEL， 获 取 根 对 象 属 性 其 
实 是 获取 容器 中 的 Bean。 


首先 看 下 配置 方式 (chapter5/el1.xml) 吧 : 


1. <bean id="world" class="java.lang.String"> 

2. <constructor-arg value="#{" World!'}"/> 

3. </bean> 

4. <bean id="hello1" class="java.lang.String"> 

5. <constructor-arg value="#{'Hello'}#{world}"/> 
6. </bean> 

7. <bean id="hello2" class="java.lang.String"> 

8. <constructor-arg value="#{'Hello' + world}"/> 

9，<I-- 不 支持 诅 套 的 --> 
10. <!--<constructor-arg value="#{'Hello'’#{world}}"/>--> 
11. </bean> 
12. <bean id="hello3" class="java.lang.String"> 
13. <constructor-arg value="#{'Hello' + @world} /> 
14. </bean> 


模板 默认 以 前 组 居 ?开头 ， 以 后 组 中 结尾 ， 且 不 允许 旗 套 ， 如 尖 {'Hello#{world} 错 误 ， 如 绑 
{Hello' + worldy’ 中 “world” 默 认 解 析 为 Bean。 当 然 可 以 使 用 “@bean” 引 用 了 。 


接 下 来 测试 一 下 吧 : 


@Test 

public void testXmlExpression() { 

ApplicationContext ctx = new ClassPathXmlApplicationContext("chapterS/el1.xml"); 
String hello1 = ctx.getBean("hello1", String.class); 

String hello2 = ctx.getBean("hello2", String.class); 

String hello3 = ctx.getBean("hello3", String.class); 

Assert.assertEquals("Hello World!", hello1); 

Assert.assertEquals("Hello World!", hello2 ); 

Assert.assertEquals("Hello World!", hello3); 


OP 和 NO 


10. 


是 不 


} 
是 很 简单 ， 除 了 XML 配 置 方式 ，Spring 还 提供 一 种 注解 方式 @Value， 接 着 往 下 看 吧 。 


5.4.2 注解 风格 的 配置 


基于 注解 风格 的 SpEL 配 置 也 非常 简单 ， 使 用 @Value 注 解 来 指定 SpEL 表 达 式 ， 该 注解 可 以 放 
到 字段 、 方 法 及 方法 参数 上 。 


测试 Bean 类 如 下 ， 使 用 @Value 来 指定 SpEL 表 达 式 : 
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package cn.javass.spring.chapter5; 

import org.springframework.beans.factory.annotation.Value; 
public class SpELBean { 

@Value("#{'Hello' + world}") 

private String value; 

//setter 和 getter 由 于 篇 幅 省 咯 ， 自 己 写 上 

} 


首先 看 下 配置 文件 (chapter5/el2.xml) : 


1. <?xml version="1.0" encoding="UTF-8"?> 

2. <beans xmlns="http://www.springframework.org/schema/beans" 
3. xmins:xsi="http:/www.w3.org/2001/XMLSchema-instance" 

4. xmlIns:context="http://www.springframework.org/schema/context" 
5. 
6 
7 
8 
9 


xsi:schemaLocation=" 


. http://www.springframework.org/schema/beans 

. http:/www.springframework.org/schema/beans/spring-beans-3.0.xsd 

. http:/www.springframework.org/schema/context 

. http:/www.springframework.org/schema/context/spring-context-3.0.xsd"&gt; 


<context:annotation-config/> 


. <bean id="world" class="java.lang.String"> 


<constructor-arg value="#{" World!'}"/> 

</bean> 

<bean id="helloBean1" class="cn.javass.spring.chapter5.SpELBean'"/> 
<bean id="helloBean2" class="cn.javass.spring.chapter5.SpELBean"> 
<property name="value" value="haha"/> 

</bean> 

</beans> 


配置 时 必须 使 用 "<context:annotation-config/>”" 来 开启 对 注解 的 支持 。 


有 了 配置 文件 那 开 始 测试 吧 : 


@Test 

public void testAnnotationExpression() { 

ApplicationContext ctx = new ClassPathXmlApplicationContext("chapterS/el2.xml"); 
SpELBean helloBean1 = ctx.getBean("helloBean1", SpELBean.class); 
Assert.assertEquals("Hello World!", helloBean1.getValue()); 

SpELBean helloBean2 = ctx.getBean("helloBean2", SpELBean.class); 
Assert.assertEquals("haha", helloBean2.getValue()); 


} 


其 中 “helloBean1 ” 值 是 SpEL 表 达 式 的 值 ， 而 “helloBean2” 是 通过 setter 注 入 的 值 ， 这 说 明 
setter 注 入 将 履 盖 @Value 的 值 。 
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5.4.3 在 Bean 定 义 中 SpEL 的 问题 


如 果 有 同学 问 哄 [我 不 是 SpEL 表 达 式 ?不 是 SpEL 表 达 式 ， 而 是 公司 内 部 的 模板 ， 想 换个 前 级 和 
后 级 该 如 何 实现 呢 ? 


那 我 们 来 看 下 Spring 如 何在 loC 容 器 内 使 用 BeanExpressionResolver 接 口 实现 来 求 值 SpEL 表 
达 式 ， 那 如 果 我 们 通过 某 种 方式 获取 该 接口 实现 ， 然 后 把 前 缓 后 缓 修改 了 不 就 可 以 了 。 


此 处 我 们 使 用 BeanFactoryPostProcessor 接 口 提供 postProcessBeanFactory 回 调 方法 ， 它 是 
在 loC 容 器 创建 好 但 还 未 进行 任何 Bean 初 始 化 时 被 ApplicationContext 实 现 调用 ， 因 此 在 这 个 
阶段 把 SpEL 前 级 及 后 缀 修改 掉 是 安全 的 ， 具 体 代 码 如 下 : 


1. package cn.javass.spring.chapter5; 
2. import org.springframework.beans.BeansException.; 
3. import org.springframework.beans.factory.config.BeanFactoryPostProcessor; 
4. import org.springframework.beans .factory.config.ConfigurableListableBeanFactory:; 
5. import org.springframework.context.expression.StandardBeanExpressionResolver; 
6. public class SpELBeanFactoryPostProcessor implements BeanFactoryPostProcessor { 
7. @Override 
8. public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) 
9. throws BeansException { 

10. StandardBeanExpressionResolver resolver = (StandardBeanExpressionResolver) 

beanFactory.getBeanExpressionResolver(); 

11. resolver.setExpressionPrefix("%{”); 

12. resolver.setExpressionSuffix("}"); 

13. } 

14. } 


首先 通过 ConfigurableListableBeanFactory 的 getBeanExpressionResolver 方 法 获取 
BeanExpressionResolver 实 现 ， 其 次 强制 类 型 转换 为 StandardBeanExpressionResolver， 其 
为 Spring 默认 实现 ， 然 后 改 掉 前 组 及 后 缓 。 


开始 测试 吧 ， 首 先 准 备 配置 文件 (chapter5/el3.xml) : 


. <?xml version="1.0" encoding="UTF-8"?> 

. <beans xmlns="http:/www.springframework.org/schema/beans" 
. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

. xmlns:context="http://www.springframework.org/schema/context" 


1 

2 

3 

4 

5. xsi:schemaLocation=" 
6. http://www.springframework.org/schema/beans 

7. http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 

8. http://www.springframework.org/schema/context 

9. http://www.springframework.org/schema/context/spring-context-3.0.xsd"&gt; 
10. <context:annotation-config/> 

11. <bean class="cn.javass.spring.chapter5.SpELBeanFactoryPostProcessor /> 
12. <bean id="world" class="java.lang.String"> 

13. <constructor-arg value="%{ World!'}"/> 

14. </bean> 

15. <bean id="helloBean1" class="cn.javass.spring.chapter5.SpELBean"/> 

16. <bean id="helloBean2" class="cn.javass.spring.chapter5.SpELBean"> 

17. <property name='"value" value="%{'Hello' + world}"/> 

18. </bean> 

19. </beans> 


配置 文件 和 注解 风格 的 几乎 一 样 ， 只 有 SpEL 表 达 式 前 缓 变 为 “%{f 了 ， 并 且 注 册 
了 “cn.javass.spring.chapter5.SpELBeanFactoryPostProcessor"Bean ， 用 于 修改 前 级 和 后 级 
的 。 


写 测试 代码 测试 一 下 吧 : 


@Test 

public void testPrefixExpression() { 

ApplicationContext ctx = new ClassPathXmlApplicationContext("chapterS/el3.xml"); 
SpELBean helloBean1 = ctx.getBean("helloBean1", SpELBean.class); 
Assert.assertEquals("#{'Hello' + world}", helloBean1.getValue()); 

SpELBean helloBean2 = ctx.getBean("helloBean2", SpELBean.class); 
Assert.assertEquals("Hello World!", helloBean2.getValue()); 


} 


此 处 helloBean1 中 通过 @Value 注 入 的 #{'Hello' + worldy 结 果 还 是 并 (Hello' + world}" 说 明 不 对 
其 进行 SpEL 表 达 式 求 值 了 ， 而 helloBean2 使 用 “%{'Hello' + world》" 注 入 ， 得 到 正确 的 "Hello 
WorldY” 。 
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【第 六 章 】 AOP 之 6.1 AOP 基 础 一 — 跟 我 学 
spring3 


6.1.1 AOP 是 什么 


考虑 这 样 一 个 问题 : 需要 对 系统 中 的 某 些 业务 做 日 志 记 录 ， 比 如 支付 系统 中 的 支付 业务 需要 
记录 支付 相关 上 日志， 对 于 支付 系统 可 能 相当 复杂 ， 比 如 可 能 有 自己 的 支付 系统 ， 也 可 能 引入 
第 三 方 支付 平台 ， 面 对 这 样 的 支付 系统 该 如 何 解 决 呢 ? 

e 传统 解决 方案 : 
1) 日 志 部 分 提前 公共 类 LogUtils， 定 义 "IongPayBegin" 方 法 用 于 记录 支付 开始 日 
志 ，“logPayEnd” 用 于 记录 支付 结果 : 


LogUtls 


logPayBegintlong usetId, long tnoney) 
logPayEndtlong userld, long roney, boolean success) 





2) 支付 部 分 ， 定 义 IPayService 接 口 并 定义 支付 方法 “pay”， 并 定义 了 两 个 实 
现 :“PointPayService” 表 示 积分 支付 ，“RMBPayService”" 表 示人 民 币 支付 ; 并 且 在 每 个 支付 
实现 中 支付 逻辑 和 记录 日 志 : 


TARTF 
LongUtlslogPayBeglxtusezdd, money), 


支付 远 怪 
boolean payllong userld, long money) LongeUtilsloePayEndnuseldd, money, success); 


PointPayService RNB PayService 


boolean pay(long userld, long money’) boolean paytlong userld, long tnoney) 


3) 支付 实现 很 明显 有 重复 代码 ， 这 个 重复 很 明显 可 以 使 用 模板 设计 模式 消除 重复 : 





























LemnzUtblsloeFayBeentuserld, mneW, 
boolean paytlone usetld, long thonew) boolean sucoess = payIntemalusedd, mney); 
LenzUtblsloeFayEndiusedd, money, success), 


Loeme UhlslosFayBeel - 
booclean payilone usefd, 1ong tt onew) 支付 浊 拉 ee 
booleanpayltternalllone usetld, long moneW) LemeUtilsloe PayEndiuseldd, mney, suoress), 

PantPays ervice 】 RNBPays ervice 
boolean paylriernalllone usetld, long monesy) 


boolean payInternalllone usetld, lone monew) 
4) 到 此 我 们 设计 了 一 个 可 以 复 用 的 接口 ; 但 大 家 觉得 这 样 记录 日 志 会 很 好 吗 ， 有 没有 更 好 的 
解决 方案 ? 










如 果 对 积分 支付 方式 添加 统计 功能 ， 比 如 在 支付 时 记录 下 用 户 总 积分 数 、 当 前 消费 的 积分 
数 ， 那 我 们 该 如 何 做 呢 ? 直接 修改 源 代码 添加 日 志 记录 ， 这 完全 违背 了 面向 对 象 最 重要 的 原 
则 之 一 : 开 闭 原则 (对 扩展 开放 ， 对 修改 关闭 ) ? 


。 更 好 的 解决 方案 : 在 我 们 的 支付 组 件 中 由 于 使 用 了 日 志 组 件 ， 即 日 志 模 块 横 切 于 支付 组 
件 ， 在 传统 程序 设计 中 很 难 将 日 志 组 件 分 离 出 来 ， 即 不 耦合 我 们 的 支付 组 件 ; 因此 面向 
方面 编程 AOP 就 诞生 了 ， 它 能 分 离 我 们 的 组 件 ， 使 组 件 完 全 不 耦合 : 


1) 采用 面向 方面 编程 后 ， 我 们 的 支付 组 件 看 起 来 如 下 所 示 ， 代 码 中 不 再 有 日 志 组 件 的 任何 东 


西 ; 
只 有 支 讨 还 组 


boolean pay( long UsetId,longtnoney) 
PointPayService | RNB PayService 
boolean pay(long userld, long roney) boolean paytlong userld, long oney) 
2) 所 以 日 志 相关 的 提取 到 一 个 切面 中 ，AOP 实 现 者 会 在 合适 的 时 候 将 日 志 功 能 织 入 到 我 们 的 
支付 组 件 中 去 ， 从 而 完全 解 耦 支 付 组 件 和 日 志 组 件 。 


Logaspect 





















logPayBeein long userld, long money) 
]ogPayEndllong userld, long money, boolean success) 


看 到 这 大 家 可 能 不 是 很 理解 ， 没 关系 ， 先 往 下 看 。 


面向 方面 编程 (AOP) : 也 可 称 为 面向 切面 编程 ， 是 一 种 编程 范式 ， 提 供 从 另 一 个 角度 来 考 
虑 程序 结构 从 而 完善 面向 对 象 编程 (DOP) 。 
| 


在 进行 OOP 开 发 时 ， 都 是 基于 对 组 件 (比如 类 ) 进行 开发 ， 然 后 对 组 件 进行 组 合 ，OOP 最 大 
问题 就 是 无 法 解 耦 组 件 进行 开发 ， 比 如 我 们 上 边 举 例 ， 而 AOP 就 是 为 了 克服 这 个 问题 而 出 现 
的 ， 它 来 进行 这 种 耦合 的 分 离 。 


AOP 为 开发 者 提供 一 种 进行 横 切 关注 点 〈 比 如 日 志 关 注 点 横 切 了 支付 关注 点 ) 分 离 并 织 入 的 
机 制 ， 把 横 切 关注 点 分 离 ， 然 后 通过 某 种 技术 织 入 到 系统 中 ， 从 而 无 耦合 的 完成 了 我 们 的 功 


全 
月 忆 2 


6.1.2 能 干什么 
AOP 主 要 用 于 横 切 关注 点 分 离 和 织 入 ， 因 此 需要 理解 横 切 关注 点 和 织 入 : 


e 关注 点 ; 可 以 认为 是 所 关注 的 任何 东西 ， 比 如 上 边 的 支付 组 件 ; 
。 关注 点 分 离 : 将 问题 细 化 从 而 单独 部 分 ， 即 可 以 理解 为 不 可 再 分 割 的 组 件 ， 如 上 边 的 日 


志 组 件 和 支付 组 件 ; 
。 横 切 关注 点 : 一 个 组 件 无 法 完成 需要 的 功能 ， 需 要 其 他 组 件 协作 完成 ， 如 日 志 组 件 横 切 
于 支付 组 件 ; 


e@ 织 入 : 横 切 关注 点 分 离 后 ， 需 要 通过 让 


合 到 系统 中 从 而 完成 需要 
的 功能 ， 因 此 需要 织 入 ， 织 入 可 能 在 编译 期 、 加 载 期、 运行 期 等 


| 
进行 。 


横 切 关注 点 可 能 包含 很 多 ， 比 如 非 业 务 的 : 日 志 、 事 务 处 理 、 缓 存 、 性 能 统计 、 权 限 控 制 等 
等 这 些 非 业务 的 基础 功能 ; 还 可 能 是 业务 的 : 这 椒 二 基色 入 枯 扬 下 个 模块 。 如 图 6-1 


关注 点 。 ”关注 点 关 福 点 关 社 点 
组 件 异 块 。 组 件 蛋 块 ” 组件 模块 ”组 件 司 块 





图 6-1 关注 点 与 横 切 关注 点 


传统 支付 形式 ， 流 水 方式 : 


关注 把 
LogUtls 


关注 反 关注 把 
DpayServce LogUtls 


支付 记录 支付 结 





支付 业务 | 记录 支付 开始 


面向 切面 方式 ， 先 将 横 切 关注 点 分 离 ， 再 将 横 切 关注 点 织 入 到 支付 系统 中 : 


关注 点 
Ipay Service 


| | 
横 切 关注 点 和 工 0U 世 js 记录 支付 开 ’ 






懂 切 头 竹 点 分 离 后 《“ 暂 不 笠 实 现 ) 











D 录 日 志 开 始 【 将 委托 给 LogUtils ) 


Wi 记录 支付 结束 《也 委托 给 LogUtils ) 


横 切 区 沪 点 


AOP 能 干什么 


e。 用 于 横 切 关注 点 的 分 离 和 织 入 横 切 关注 点 到 系统 ; 比如 上 边 提 到 的 日 志 等 等 ; 
。 完善 OOP ; 

e 降低 组 件 和 模块 之 间 的 耦合 性 

。 使 系统 容易 扩展 ; 

e 而 且 由 于 关注 点 分 离 从 而 可 以 获得 组 件 的 更 好 复 用 。 


6.1.3 AOP 的 基本 概念 


在 进行 AOP 开 发 前 ， 先 熟悉 几 个 概念 : 


。 连接 点 (Jointpoint) : 表示 需要 在 程序 中 插入 横 切 关注 点 的 扩展 点 ， 连 接点 可 能 是 类 初 
始 化 、 方 法 执行 、 方 法 调用 、 字 段 调 用 或 处 理 异 常 等 等 ，Spring 只 支持 方法 执行 连接 点 
在 AOP 中 表示 为 “在 哪里 干 ”; 


。 切入 点 (Pointcut) : 选择 一 组 相关 连接 点 的 模式 ， 即 可 以 认为 连接 点 的 集合 ，Spring 支 


持 perl5 正 则 表达 式 和 AspectJ 切 入 点 模式 ，Spring 默 认 使 用 AspectJ 语 法 ， 在 AOP 中 表示 
为 “在 哪里 干 的 集合 ”; 

。 通知 (Advice) : 在 连接 点 上 执行 的 行为 ， 通 知 提供 了 在 AOP 中 需要 在 切入 点 所 选择 的 
连接 点 处 进行 扩展 现 有 行为 的 手段 ; 包括 前 置 通知 (before advice) 、 后 置 通 知 (after 
advice)、 环 绕 通 知 (around advice ) Fe ead ， 并 通过 拦 
器 模式 以 环绕 连接 点 的 拦截 器 链 织 入 通知 ; 在 AOP 中 表示 为 “干什么 

e 方面 /切面 (Aspect) : 横 切 关注 点 的 模块 化 ， 比 如 上 边 提 到 的 日 志 组 件 。 可 以 认为 是 
知 、 引 入 和 切入 点 的 组 合 ; 在 Spring 中 可 以 使 用 Schema 和 人 @AspectJ 方 式 进行 组 织 实 
现 ; 在 AOP 中 表示 为 “在 哪 干 和 干什么 集合 ”; 


。 引入 (inter-type declaration ) : 也 称 为 内 部 类 型 声明 ， 为 已 有 的 类 添加 额外 新 的 字段 
或 方法 ，Spring 允 许 引 入 新 的 接口 (必须 对 应 一 个 实现 ) 到 所 有 被 代理 对 象 (目标 对 
象 ) ,在 AOP 中 表示 为 “干什么 (引入 什么 ) ”; 

。 目标 对 象 (Target Object) : 需要 被 织 入 横 切 关注 点 的 对 象 ， 即 该 对 象 是 切入 点 选择 的 
对 象 ， 需 要 被 通知 的 对 象 ， 从 而 也 可 称 为 "被 通知 对 象 " ; 由 于 Spring AOP 通过 代理 模式 
实现 ， 从 而 这 个 对 象 永远 是 被 代理 对 象 ， 在 AOP 中 表示 为 “对 谁 干 ”; 

。 AOP 代 理 (AOP Proxy) : AOP 框 架 使 用 代理 模式 创建 的 对 象 ， 从 而 实现 在 连接 点 处 插 
入 通知 〈 即 应 用 切面 ) ， 就 是 通过 代理 来 对 目标 对 象 应 用 切面 。 在 Spring 中 ，AOP 代 理 
可 以 用 JDK 动 态 代理 或 CGLIB 代 理 实现 ， 而 通过 拦截 器 模型 应 用 切面 。 

。 织 入 (Weaving) : 织 入 是 一 个 过 程 ， 是 将 切面 应 用 到 目标 对 象 从 而 创建 出 AOP 代 理 对 
象 的 过 程 ， 织 入 可 以 在 编译 期 、 类 装载 期 、 运 行 期 进行 。 


在 AOP 中 ， 通 过 切入 点 选择 目标 对 象 的 连接 点 ， 然 后 在 目标 对 象 的 相应 连接 点 处 织 入 通知 ， 
ee ， 而 在 目标 对 象 连 接点 处 应 用 切面 的 实现 方式 是 通 
过 AOP 代 理 对 象 ， 如 图 6-2 所 示 。 


Pakag cm .Javass. spring. chapterb .service .inpl ; 
import cn . Javass .spring .chapter 65. service .TIPar3ervice ; 
Fblic class FointPayservice implonerks IPayService i 


BOverrige 
TeinPo int "Fblic boolean por [long userld, lmgmoney) 1 
凡 支 计 业务 交 颈 


TetUIT tme ; 


BOverrige 
~ Pblic boolean isEnovgh [long userId , long maney ] 1 
几 莹 下 用 户 质 币 尽 天 充足 业务 交 野 
( mtum tr ; 


BfterThrowinghdyv ice | } 
R 中 Qoverri 呆 
BfterlFinally)bdvice dn rit Fblic lorg grrmy [long urerId) 1 


| 上 壮 尖 用 户 身 币 业务 奖 晴 


p Tetuzm 1000; 
Broundbdyvice | } 


路 畸 示 Bdvice 执 行 点 





图 6-2 概念 关系 


接 下 来 再 让 我 们 具体 看 看 Spring 有 哪些 通知 类 型 : 


。 前 置 通知 (Before Advice) :在 切入 点 选择 的 连接 点 处 的 方法 之 前 执行 的 通知 ， 该 通知 
不 影响 正常 程序 执行 流程 (除非 该 通知 抛 出 异常 ， 该 异常 将 中 断 当 前 方法 链 的 执行 而 返 
回 ) 。 

e 后 置 通知 (After Advice) :在 切入 点 选择 的 连接 点 处 的 方法 之 后 执行 的 通知 ， 包 括 如 下 

类 型 的 后 置 通知 : 

o 后 置 返回 通知 (After returning Advice) :在 切入 点 选择 的 连接 点 处 的 方法 正常 执行 
完毕 时 执行 的 通知 ， 必 须 是 连接 点 处 的 方法 没 抛 出 任何 异常 正常 返回 时 才 调 用 后 置 
通知 。 

o 后 置 异 常 通知 (After throwing Advice) : 在 切入 点 选择 的 连接 点 处 的 方法 抛 出 异 


常 返回 时 执行 的 通知 ， 必 须 是 连接 点 处 的 方法 抛 出 任何 异常 返回 时 才 调 用 异常 通 
知 。 
o 后 置 最 终 通知 (After finally Advice) : 在 切入 点 选择 的 连接 点 处 的 方法 返回 时 执行 
的 通知 ， 不 管 抛 没 抛 出 异常 都 执行 ， 类 似 于 Java 中 的 finally 块 。 
。 环绕 通知 (Around Advices) : 环绕 着 在 切入 点 选择 的 连接 点 处 的 方法 所 执行 的 通知 ， 
环绕 通知 可 以 在 方法 调用 之 前 和 之 后 自 定义 任何 行为 ， 并 且 可 以 决定 是 否 执行 连接 点 处 
的 方法 、 赫 换 返 回 值 、 抛 出 异常 等 等 。 


各 种 通知 类 型 在 UML 序 列 图 中 的 位 置 如 图 6-3 所 示 : 


LOFTest IFawervice 








图 6-3 通知 类 型 


6.1.4 AOP 代 理 


AOP 代 理 就 是 AOP 框 架 通 过 代理 模式 创建 的 对 象 ，Spring 使 用 JDK 动 态 代理 或 CGLIB 代 理 来 
实现 ，Spring 缺 省 使 用 JDK 动 态 代理 来 实现 ， 从 而 任何 接口 都 可 别 代 理 ， 如 果 被 代理 的 对 象 实 
现 不 是 接口 将 默认 使 用 CGLIB 代 理 ， 不 过 CGLIB 代 理 当 然 也 可 应 用 到 接口 。 


AOP 代 理 的 目的 就 是 将 切面 织 入 到 目标 对 象 。 
概念 都 将 完了 ， 接 下 来 让 我 们 看 一 下 AOP 的 HelloWorld! 吧 。 


原创 内 容 转自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/2466.html] 


[第 六 章 】AOP 之 6.2 AOP 的 HelloWorld 一 一 跟 
我 学 spring3 


6.2.1 准备 环境 


首先 准备 开发 需要 的 jar 包 ， 请 到 spring-framework-3.0.5.RELEASE-dependencies.zip 和 
spring-framework-3.0.5.RELEASE-with-docs 中 查找 如 下 jar 包 : 


org.springframework.aop-3.0.5.RELEASE.jar 
com.springsource.org.aspectj.weaver-1.6.8.RELEASE. jar 
com.springsource.org.aopalliance-1.0.0.jar 


com.springsource.net.sf.cglib-2.2.0.jar 
将 这 些 jar 包 添加 到 “Build Path” 下 。 


6.2.2 定义 目标 类 
1) 定义 目标 接口 : 


1. package cn.javass.spring.chapter6.service; 
2. public interface IHelloWorldService { 

3. public void sayHello(); 

4. } 


定义 目标 接口 实现 : 


DD 


1. package cn.javass.spring.chapter6.service.impl; 

2. import cn.javass.spring.chapter6.service.IHelloWorldService; 

3. public class HelloWorldService implements IHelloWorldService { 
4. @Override 

5. public void sayHello() { 

6. System.out.println("============Hello World!"); 

7. } 

8. } 


注 : 在 日 常 开发 中 最 后 将 业务 逻辑 定义 在 一 个 专门 的 service 包 下 ， 而 实现 定义 在 service 包 下 
的 impl 包 中 ， 服 务 接口 以 [XXXService 形 式 ， 而 服务 实现 就 是 XXXService， 这 就 是 规约 设计 ， 
见 名 知 义 。 当 然 可 以 使 用 公司 内 部 更 好 的 形式 ， 只 要 大 家 都 好 理解 就 可 以 了 。 


6.2.2 定义 切面 支持 类 


有 了 目标 类 ， 该 定义 切面 了 ， 切 面 就 是 通知 和 切入 点 的 组 合 ， 而 切面 是 通过 配置 方式 定义 
的 ， 因 此 这 定义 切面 前 ， 我 们 需要 定义 切面 支持 类 ， 切 面 支 持 类 提供 了 通知 实现 : 


package cn.javass.spring.chapter6.aop; 

public class HelloWorldAspect { 

// 前 置 通知 

public void beforeAdvice() { 
System.out.printIn("===========before advice"); 
} 

// 后 置 最 终 通知 

public void afterFinallyAdvice() { 


OnmnDpDaomwmwnN 一 


System.out.println("===========after finally advice"); 
10. } 
11. } 


此 处 HelloWorldAspect 类 不 是 站 正 的 切面 实现 ， 只 是 定义 了 通知 实现 的 类 ， 在 此 我 们 可 以 把 它 
看 作 就 是 缺少 了 切入 点 的 切面 。 


: 对 于 AOP 相 关 类 最 后 专门 放 到 一 个 包 下 ， 如 “aop” 包 ， 因 为 AOP 是 动态 织 入 的 ， 所 以 如 果 
er 文 个 通知 实现 在 哪个 包 里 ， 因 此 推荐 
pn 命名 ， 方 便 以 后 维护 人 员 查 找 相 应 的 AOP 实 现 。 


6.2.3 在 XML 中 进行 配置 
有 了 通知 实现 ， 那 就 让 我 们 来 配置 切面 吧 : 
1) 首先 配置 AOP 需 要 aop 命 名 空间 ， 配 置 头 如 下 : 


. <?xml version="1.0" encoding="UTF-8"?> 

. <beans xmlns="http://www.springframework.org/schema/beans" 
. xmlns:xsi="http:/www.w3.org/2001/XMLSchema-instance”" 

. xmlns:aop="http://www.springframework.org/schema/aop" 


1 

2 

3 

4 

5. xsi:schemaLocation=" 
6. http://www.springframework.org/schema/beans 

7. http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
8. http://www.springframework.org/schema/aop 

9. http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"&gt; 


10. </beans> 
2) 配置 目标 类 


1. <bean id="helloWorldService" 
2. class="cn.javass.spring.chapter6.service.impl.HelloWorldService"/> 


3) 配置 切面 : 


. <bean id="aspect" class="cn.javass.spring.chapter6.aop.HelloWorldAspect"/> 
. <aop:config> 

. <aop:pointcut id="pointcut" expression="execution( cn.fjavass...*(..))"/> 

. <aop:aspect ref="aspect"> 


1 
2 
3 
4 
5. <aop:before pointcut-ref="pointcut" method="beforeAdvice"/> 
6. <aop:after pointcut="execution( cn.javass...*(..))" method="afterFinallyAdvice"/> 
7. </aop:aspect> 

8 


. </aop:config> 


切入 点 使 用 <aop:config> 标 签 下 的 <aop:pointcut> 配 置 ，expression 属 性 用 于 定义 切入 点 模 
式 ， 默 认 是 AspectJ 语 法 ，“execution( cn.javass...*(..))” 表 示 匹 配 cn.javass 包 及 子 包 下 的 任何 
方法 执行 。 


切面 使 用 <aop:config> 标 签 下 的 <aop:aspect> 标 签 配 置 ， 其 中 “ref* 用 来 引用 切面 支持 类 的 方 
法 。 


前 置 通知 使 用 <aop:aspect> 标 签 下 的 <aop:before> 标 签 来 定义 ，pointcut-ref 属 性 用 于 引用 切 
入 点 Bean， 而 method 用 来 引用 切面 通知 实现 类 中 的 方法 ， 该 方法 就 是 通知 实现 ， 即 在 目标 类 
方法 执行 之 前 调用 的 方法 。 


最 终 通知 使 用 <aop:aspect> 标 签 下 的 <aop:after > 标签 来 定义 ， 切 入 点 除了 使 用 pointcut-ref 属 
性 来 引用 已 经 存在 的 切入 点 ， 也 可 以 使 用 pointcut 属 性 来 定义 ， 如 pointcut="execution( 
cn.javass...*(..))"”，method 属 性 同样 是 指定 通知 实现 ， 即 在 目标 类 方法 执行 之 后 调用 的 方法 。 


6.2.4 运行 测试 


测试 类 非常 简单 ， 调 用 被 代理 Bean 跟 调用 普通 Bean 完 全 一 样 ，Spring AOP 将 为 目标 对 象 创 
建 AOP 代 理 ， 具 体 测试 代码 如 下 : 


package cn.javass.spring.chapter6; 

import org.junit. Test; 

import org.springframework.context.ApplicationContext; 

import org.springframework.context.support.ClassPathXmlApplicationContext; 
import cn.javass.spring.chapter6.service.IHelloWorldService; 

import cn.javass.Sspring.chapter6.service.IPayService; 

public class AopTest { 

@Test 

public void testHelloworld() { 


OO 和 NO 人 oD 


~、 


ApplicationContext ctx = new 
ClassPathXmlApplicationContext("chapter6/helloworld.xml"); 


一 人 
一 人 


.|IHelloWorldService helloworldService = 


12. ctx.getBean("helloWorldService", IHelloWorldService.class); 
13. helloworldService.sayHello(); 

14. } 

15. } 


该 测试 将 输出 如 下 如 下 内 容 : 


1. ===========before advice 
2. ============Hello World! 
3. ===========after finally advice 


从 输出 我 们 可 以 看 出 : 前 置 通知 在 切入 点 选择 的 连接 点 (方法 ) 之 前 允许 ， 而 后 置 通知 将 在 
连接 点 (方法) 之 后 执行 ， 上 有 具体 生 成 AOP 代 理 及 执行 过 程 如 图 6-4 所 示 。 


切面 通知 实现 类 


2、 选 择 通 知 实 现 
对 匹配 切入 点 的 连接 点 
应 用 通知 Pointcut 


eXecutionls cn.javass..*.*{(..)) 
Advice 


1 
条 人 
只 对 婚配 的 的 目标 对 象 
mas 

1 











六 0F 民 理 对 象 






z, 执行 目标 对 香 广 活 -一 | 调用 
+sayHellol) 二 党 | 3, 执行 后 置 最 绕 通 加 






图 6-4 Spring AOP 框 架 生成 AOP 代 理 过 程 


原创 内 容 转自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/2467.html] 
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3 基于 Schema 的 AOP 


基于 Schema 的 AOP 从 Spring2.0 之 后 通过 “aop"” 命 名 空间 来 定义 切面 、 切 入 点 及 声明 通知 。 


在 Spring 配置 文件 中 ， 所 以 AOP 相 关 定 义 必 须 放 在 <aop:config> 标 签 下 ， 该 标签 下 可 以 有 
<aop:pointcut>、<aop:advisor>、<aop:aspect> 标 签 ， 配 置 顺序 不 可 变 。 


。 <aop:pointcut> : 用 来 定义 切入 点 ， 该 切入 点 可 以 重用 ; 

。 <aop:advisor> : 用 来 定义 只 有 一 个 通知 和 一 个 切入 点 的 切面 ; 

e <aop:aspect> : 用 来 定义 切面 ， 该 切面 可 以 包含 多 个 切入 点 和 通知 ， 而 且 标 签 内 部 的 通 
知 和 切入 点 定义 是 无 序 的 ; 和 advisor 的 区 别 就 在 此 ，advisor 只 包含 一 个 通知 和 一 个 切入 
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<agpiconfis>。 | | AOP 定 义 开 始 ( 有 序 )。 

“aoppomteyt > | 切入 后 定义 《 零 个 或 多 个 )。 
,opsadvisgt > | | Advisor 定 义 《 零 个 或 多 个 ) 

gpBiaspect | .| 切面 定义 开始 “ 零 个 或 多 个 ， 无 序 》， 
<aop:pomteut/>. | 切入 点 定义 “ 零 个 或 多 个 )。 

.前 置 通知 《 零 个 或 多 个 )。 | 

nit ee | 局 置 返回 通知 《 零 个 或 多 个 )。 


<aopiafier-throwing/>+ | | 后 年 异 铝 通知 、 (个 或 个 ) 。 
=aop:atter/>+ | 置 最 终 通 知 《 零 个 或 多 个 ) ， 
环绕 通知 《 零 个 或 多 个 )。 

aop:declare-parents>。 | | 3 引入 定义 ( 零 个 或 多 个 )。 
fone | ”切面 定义 开始 《 零 个 或 多 个 ) 。 


| oP 定义 结 十 束 。 





6.3.1 声明 切面 


切面 就 是 包含 切入 点 和 通知 的 对 象 ， 在 Spring 容器 中 将 被 定义 为 一 个 Bean，Schema 方 式 的 切 
面 需要 一 个 切面 支持 Bean， 该 支持 Bean 的 字段 和 方法 提供 了 切面 的 状态 和 行为 信息 ， 并 通过 
配置 方式 来 指定 切入 点 和 通知 实现 。 


切面 使 用 <aop:aspect> 标 签 指定 ，ref 属 性 用 来 引用 切面 支持 Bean。 


切面 支持 Bean“aspectSupportBean" 跟 普通 Bean 完 全 一 样 使 用 ， 切 面 使 用 “ref' 属 性 引用 它 。 


6.3.2 声明 切入 点 
切入 点 在 Spring 中 也 是 一 个 Bean，Bean 定 义 方 式 可 以 有 很 三 种 方式 : 


1) 在 <aop:config> 标 签 下 使 用 <aop:pointcut> 声 明 一 个 切入 点 Bean， 该 切入 点 可 以 被 多 个 
切面 使 用 ， 对 于 需要 共享 使 用 的 切入 点 最 好 使 用 该 方式 ， 该 切入 点 使 用 id 属性 指定 Bean 名 

字 ， 在 通知 定义 时 使 用 pointcut-ref 属 性 通过 该 jd 引用 切入 点 ，expression 属 性 指定 切入 点 表达 
式 : 


<aop:config> 

<aop:pointcut id="pointcut" expression="execution( cn.javass...*(..))"/> 
<aop:aspect ref="aspectSupportBean"> 

<aop:before pointcut-ref="pointcut" method="before"/> 

</aop:aspect> 
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6. </aop:config> 


2) 在 <aop:aspect> 标 签 下 使 用 <aop:pointcut> 上 声明 一 个 切入 点 Bean， 该 切入 点 可 以 被 多 个 
切面 使 用 ， 但 一 般 该 切入 点 只 被 该 切面 使 用 ， 当 然 也 可 以 被 其 他 切面 使 用 ， 但 最 好 不 要 那样 
使 用 ， 该 切入 点 使 用 id 属性 指定 Bean 名 字 ， 在 通知 定义 时 使 用 pointcut-ref 属 性 通过 该 jd 引用 切 
入 点 ，expression 属 性 指定 切入 点 表达 式 : 


1. <aop:config> 

2. <aop:aspect ref="aspectSupportBean"> 

3. <aop:pointcut id=" pointcut" expression="execution( cn.javass...*(..))"/> 
4. <aop:before pointcut-ref="pointcut" method="before"/> 

5. </aop:aspect> 

6. </aop:config> 


3) 匿名 切入 点 Bean， 可 以 在 声明 通知 时 通过 pointcut 属 性 指定 切入 点 表达 式 ， 该 切入 点 是 碟 
名 切入 点 ， 只 被 该 通知 使 用 : 


<aop:config> 

<aop:aspect ref="aspectSupportBean"> 

<aop:after pointcut="execution( cn.javass...*(..))" method="afterFinallyAdvice"/> 
</aop:aspect> 
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</aop:config> 


6.3.3 声明 通知 
基于 Schema 方式 支持 前 边 介绍 的 5 中 通知 类 型 : 


前 置 通知 : 在 切入 点 选择 的 方法 之 前 执行 ， 通 过 <aop:aspect> 标 签 下 的 <aop:before> 标 


1. <aop:before pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 
2. method=" 前 置 通知 实现 方法 名 " 
3. arg-names=" 前 置 通知 实现 方法 参数 列表 参数 名 字 "/> 


pointcut 和 pointcut-ref : 二 者 选 一 ， 指 定 切入 点 ; 


method : 指定 前 置 通知 实现 方法 名 ， 如 果 是 多 态 需 要 加 上 参数 类 型 ， 多 个 用 “，” 隔 开 ， 如 
beforeAdvice(java.lang.String) ; 


arg-names : 指定 通知 实现 方法 的 参数 名 字 ， 多 个 用 “，” 分 隔 ， 可 选 ， 类 似 于 【3.1.2 构造 器 
注入 】 中 的 参数 名 注入 限制 : 在 class 文 件 中 没 生成 变量 调试 信息 是 获取 不 到 方法 参数 名 字 

的 ， 因 此 只 有 在 类 没 生 成 变量 调试 信息 时 才 需 要 使 用 arg-names 属 性 来 指定 参数 名 ， 如 arg- 
names="param" 表 示 通 知 实现 方法 的 参数 列表 的 第 一 个 参数 名 字 为 “param”。 


首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public void sayBefore(String param); 


其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


1. @Override 

2. public void sayBefore(String param) { 

3. System.out.println("============Say "+ param); 
4. } 


第 三 在 cn.javass.spring.chapter6.aop. HelloWorldAspect 定 义 通知 实现 : 


1. public void beforeAdvice(String param) { 
2. System.out.println("===========before advice param:" + param); 
3. } 


最 后 在 chapter6/advice.xml 配 置 文件 中 进行 如 下 配置 : 


1. <bean id="helloWorldService" 
class="cn.javass.spring.chapter6.service.impl.HelloWorldService"/> 

<bean id="aspect" class="cn.javass.spring.chapter6.aop.HelloWorldAspect"/> 
<aop:config> 

<aop:aspect ref="aspect"> 

<aop:before pointcut="execution( cn.javass...sayBefore(..)) and args(param)" 
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method="beforeAdvice(java.lang.String)" 


7. arg-names="param"/> 
8. </aop:aspect> 
9. </aop:config> 


测试 代码 cn.javass.spring.chapter6.AopTest: 


@Test 

public void testSchemaBeforeAdvice(){ 
System.out.printIn("======================================"); 
ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 
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IHelloWorldService helloworldService = ctx.getBean("helloWorldService", 
IHelloWorldService.class); 

6. helloworldService.sayBefore("before"); 

7 


===========before advice param:before 
============SaAy before 


分 析 一 下 吧 : 


1) 切入 点 匹配 : 在 配置 中 使 用 "execution( cn.javass...sayBefore(..)) "匹配 目标 方法 
sayBefore， 且 使 用 "args(paramy" 匹 配 目标 方法 只 有 一 个 参数 且 传 入 的 参数 类 型 为 通知 实现 方 
法 中 同名 的 参数 类 型 ; 


2) 目标 方法 定义 : 使 用 method=" beforeAdvice(java.lang.String) "指定 前 置 通知 实现 方法 ， 
且 该 通知 有 一 个 参数 类 型 为 java.lang.String 参 数 ; 


3) 目标 方法 参数 命名 : 其 中 使 用 arg-names=" param "指定 通知 实现 方法 参数 名 为 <param”， 
切入 点 中 使 用 “args(param) 匹配 的 目标 方法 参数 将 自动 传递 给 通知 实现 方法 同名 参数 。 


二 、 后 置 返回 通知 : 在 切入 点 选择 的 方法 正常 返回 时 执行 ， 通 过 <aop:aspect> 标 签 下 的 
<aop:after-returning> 标 签 声 明 : 


<aop:after-returning pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 
method=" 后 置 返 回 通 知 实现 方法 名 " 

arg-names=" 后 置 返回 通知 实现 方法 参数 列表 参数 名 字 " 
returning=" 返 回 值 对 应 的 后 置 返回 通知 实现 方法 参数 名 " 


/> 


POD 


pointcut 和 pointcut-ref : 同 前 置 通知 同 义 ; 
method : 同 前 置 通知 同 义 ; 
arg-names : 同 前 置 通知 同 义 ; 


returning : 定义 一 个 名 字 ， 该 名 字 用 于 匹配 通知 实现 方法 的 一 个 参数 名 ， 当 目标 方法 执行 正 
常 返回 后 ， 将 把 目 ee ; returning 限 定 了 只 有 目标 方法 返回 值 匹 配 与 
通知 方法 相应 参数 类 型 时 才能 执行 后 置 返回 通知 ， 和 否则 不 执行 ， 对 于 returning 对 应 的 通知 方 
法 参数 为 Object 类 型 将 匹配 任何 目标 返回 值 。 


首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public boolean sayAfterReturning(); 
其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


@Override 

public boolean sayAfterReturning() { 
System.out.printIn("============after returning"); 
return true; 


第 三 在 cn.javass.spring.chapter6.aop. HelloWorldAspect 定 义 通知 实现 : 


POD 


1. public void afterReturningAdvice(Object retVal) { 
2. System.out.printIn("===========after returning advice retVal:" + retVal); 
3. } 


后 在 chapter6/advice.xml 配 置 文件 中 接着 前 置 通知 配置 的 例子 添加 如 下 配置 


<aop:after-returning pointcut="execution( cn.javass...sayAfterReturning(..))" 
method="afterReturningAdvice" 
arg-names="retVal" 
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returning="retVal"/> 
测试 代码 cn.javass.spring.chapter6.AopTest: 


. @lTest 
. public void testSchemaAfterReturningAdvice() { 


. ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 
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. IHelloWorldService helloworldService = ctx.getBean("helloWorldService", 
IHelloWorldService.class); 
6. helloworldService.sayAfterReturning(); 


============after returning 


===========after returning advice retVal:true 


分 析 一 下 吧 : 


1) 切入 点 匹配 : 在 配置 中 使 用 “execution( cn.javass...sayAfterReturning(..)) "匹配 目标 方法 
sayAfterReturning， 该 方法 返回 true ; 


2) 目标 方法 定义 : 使 用 method="afterReturningAdvice" 指 定 后 置 返回 通知 实现 方法 ; 
3) 目标 方法 参数 命名 : 其 中 使 用 arg-names="retVal" 指 定 通知 实现 方法 参数 名 为 “retVal” ; 


4) 返回 值 命名 : returning="retVal" 用 于 将 目标 返回 值 赋值 给 通知 实现 方法 参数 名 为 “retVal” 的 
参数 上 。 


后 置 异 常 通知 : 在 切入 点 选择 的 方法 抛 出 异常 时 执行 ， 通 过 <aop:aspect> 标 签 下 的 
a 明 : 


1. <aop:after-throwing pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 
2.，method=" 后 置 异 常 通知 实现 方法 名 " 

3.，arg-names=" 后 置 异常 通知 实现 方法 参数 列表 参数 名 字 " 

4. throwing=" 将 抛 出 的 异常 赋值 给 的 通知 实现 方法 参数 名 "/> 


pointcut 和 pointcut-ref : 同 前 置 通知 同 义 ; 
method : 同 前 置 通知 同 义 ; 
arg-names : 同 前 置 通知 同 义 ; 


人 定义 一 个 名 字 ， 该 名 字 用 于 匹配 通知 实现 方法 的 一 个 参数 名 ， 当 目标 方法 抛 出 异 

常 返 回 后 ， 将 把 目标 方法 抛 出 的 异常 传 给 通知 方法 ; throwing 限 定 了 只 有 目标 方法 抛 出 的 异常 
匹配 与 通知 方法 相应 参数 异常 类 型 时 才能 执行 后 置 异 常 通知 ， 否 则 不 执行 ， 对 于 throwing 对 应 
的 通知 方法 参数 为 Throwable 类 型 将 匹配 任何 异常 。 


首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public void sayAfterThrowing(); 
其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


1. @Override 


. public void sayAfterThrowing() { 


. throw new RuntimeException(); 


2 
3. System.out.println("============before throwing"); 
4 
5. } 


第 三 在 cn.javass.spring.chapter6.aop. HelloWorldAspect 定 义 通知 实现 : 


1. public void afterThrowingAdvice(Exception exception) { 
2. System.out.println("===========after throwing advice exception:" + exception); 
3: 站 


最 后 在 chapter6/advice.xml 配 置 文件 中 接着 前 置 通知 配置 的 例子 添加 如 下 配置 : 


1. <aop:after-throwing pointcut="execution( cn.javass...sayAfterThrowing(..))" 
2. method="afterThrowingAdvice" 

3. arg-names="exception" 

4. throwing="exception"/> 


测试 代码 cn.javass.spring.chapter6.AopTest: 


@Test(expected = RuntimeException.class) 

public void testSchemaAfterThrowingAdvice(){ 
System.out.printIn("======================================"); 
ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 
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IHelloWorldService helloworldService = ctx.getBean("helloWorldService", 
IHelloWorldService.class); 
6. helloworldService.sayAfterThrowing(); 


============before throwing 
===========after throwing advice exception:java.lang.RuntimeException 


分 析 一 下 吧 : 


1) 切入 点 匹配 : 在 配置 中 使 用 “execution( cn.javass...sayAfterThrowing(..))” 匹 配 目 标 方法 
sayAfterThrowing， 该 方法 将 抛 出 RuntimeException 蜡 常 ; 


2) 目标 方法 定义 : 使 用 method="afterThrowingAdvice" 指 定 后 置 异 常 通知 实现 方法 ; 


3) 目标 方法 参数 命名 : 其 中 使 用 arg-names="exception" 指 定 通知 实现 方法 参数 名 
为 “exception”; 


4) 异常 命名 : returning="exception" 用 于 将 目标 方法 抛 出 的 异常 赋值 给 通知 实现 方法 参数 名 
为 “exception” 的 参数 上 。 


四 、 后 置 最 终 通 知 : 在 切入 点 选择 的 方法 返回 时 执行 ， 不 管 是 正常 返回 还 是 抛 出 异常 都 执 


a 


行 ， 通 过 <aop:aspect> 标 签 下 的 <aop:after > 标签 声明 : 


1.<aop:after pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 


method=" 后 置 最 终 通知 实现 方法 名 " 
3. arg-names=" 后 置 最 终 通知 实现 方法 参数 列表 参数 名 字 "/> 


D 


pointcut 和 pointcut-ref : 同 前 置 通知 同 义 ; 

method : 同 前 置 通知 同 义 ; 

arg-names : 同 前 置 通知 同 义 ; 

首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public boolean sayAfterFinally(); 

其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


@Override 

public boolean sayAfterFinally() { 
System.out.printIn("============before finally"); 
throw new RuntimeException(); 


} 


pO DD 


第 三 在 cn.javass.spring.chapter6.aop. HelloWorldAspect 定 义 通知 实现 : 


1. public void afterFinallyAdvice() { 
2. System.out.println("===========after finally advice"); 
33 


最 后 在 chapter6/advice.xml 配 置 文件 中 接着 前 置 通知 配置 的 例子 添加 如 下 配置 


1. <aop:after pointcut="execution( cn.javass...sayAfterFinally(..))" 
2. method="afterFinallyAdvice"/> 


测试 代码 cn.javass.spring.chapter6.AopTest: 
1. @Test(expected = RuntimeException.class) 


2. public void testSchemaAtfterFinallyAdvice() { 


4. ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 


5. |IHelloWorldService helloworldService = ctx.getBean("helloWorldService", 
IHelloWorldService.class); 
6. helloworldService.sayAfterFinally(); 


三 三 三 三 三 三 三 三 三 三 三 三 的 二 丰 OIEG finally 


===========after finally advice 


分 析 一 下 吧 : 


1) 切入 点 匹配 : 在 配置 中 使 用 “execution( cn.javass.. yal nly .)? 匹 配 目标 方法 
sayAfterFinally， 该 方法 将 执 出 RuntimeException 异 常 


2) 目标 方法 定义 : 使 用 method=" afterFinallyAdvice "指定 后 置 最 终 通 知 实现 方法 。 


五 、 环 绕 通 知 : 环绕 着 在 切入 点 选择 的 连接 点 处 的 方法 所 执行 的 通知 ， 环 绕 人 ， 
可 以 决定 目标 方法 是 否 执行 ， 什 么 时 候 执行 ， 执 行 时 是 否 需 要 替换 方法 参数 ， 执 行 完 
需要 替换 返回 值 ， 可 通过 <aop:aspect> 标 签 下 的 <aop:around > 标签 声明 : 


1.<aop:around pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 
2. method=" 后 置 最 终 通知 实现 方法 名 " 
3. arg-names=" 后 置 最 终 通知 实现 方法 参数 列表 参数 名 字 "/> 


pointcut 和 pointcut-ref : 同 前 置 通知 同 义 ; 
method : 同 前 置 通知 同 义 ; 
arg-names : 同 前 置 通知 同 义 ; 


环绕 通知 第 一 个 参数 必须 是 org.aspectj.lang.ProceedingJoinPoint 类 型 ， 在 通知 实现 方法 内 部 
使 用 ProceedingJoinPoint 的 proceed() 方 法 使 目标 方法 执行 ，proceed 方法 可 以 传 入 可 选 的 
Object[] 数 组 ， 该 数组 的 值 将 被 作为 目标 方法 执行 时 的 参数 。 


首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public void sayAround(String param); 
其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


1. @Override 
2. public void sayAround(String param) { 


3. System.out.println("============around param:" + param); 
4. } 


第 三 在 cn.javass.spring.chapter6.aop. HelloWorldAspect 定 义 通知 实现 : 


1. public Object aroundAdvice(ProceedingJoinPoint pjp) throws Throwable { 
2. System.out.printIn("===========around before advice"); 

3. Object retVal = pjp.proceed(new Object[] {"replace")); 

4. System.out.printIn("===========around after advice"); 

5. return retVal; 

6. } 


最 后 在 chapter6/advice.xml 配 置 文件 中 接着 前 置 通知 配置 的 例子 添加 如 下 配置 : 


1. <aop:around pointcut="execution( cn.javass...sayAround(..))" 
2. method="aroundAdvice"/> 


测试 代码 cn.javass.spring.chapter6.AopTest: 


1. @lTest 

2. public void testSchemaAroundAdvice() { 

3. System.out.printIn("======================================"); 
4. ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 
5. lHelloWorldService helloworldService = 

6. ctx.getBean("helloWorldService", IHelloWorldService.class); 

7. helloworldService.sayAround("haha"); 

8. System.out.printIn("======================================"); 
9. } 
将 输入 : 

===========around before advice 

============around param:replace 

===========around after advice 
分 析 一 下 吧 : 


1) 切入 点 匹配 : 在 配置 中 使 用 “execution( cn.javass...sayAround(..))” 匹 配 目 标 方法 
sayAround ; 


2) 目标 方法 定义 : 使 用 method="aroundAdvice" 指 定 环绕 通知 实现 方法 ， 在 该 实现 中 ， 第 一 
个 方法 参数 为 pp， 类 型 为 ProceedingJoinPoint， 其 中 “Object retVal = pjp.proceed(new 
Object[] {"replace"});”， 用 于 执行 目标 方法 ， 且 目标 方法 参数 被 “new Object[] {"replace'" 替 
换 ， 最 后 返回 “retVal "返回 值 。 


3) 测试 : 我 们 使 用 “helloworldService.sayAround("haha");” 传 入 参数 为 “haha”， 但 最 终 输 出 
为 “replace”， 说 明 参 数 被 替换 了 。 


6.3.4 5 引 入 


Spring 引入 允许 为 目标 对 象 引 入 新 的 接口 ， 通 过 在 < aop:aspect> 标 签 内 使 用 < aop:declare- 
parents> 标 签 进行 引入 ， 定 义 方式 如 下 : 


<aop:declare-parents 
types-matching="AspectJ 语 法 类 型 表达 式 " 
implement-interface= 引 入 的 接口 " 
default-impl=" 引 入 接口 的 默认 实现 " 
delegate-ref=" 引 入 接口 的 默认 实现 Bean 引 用 "/> 


POD 


types-matching : 匹配 需要 引入 接口 的 目标 对 象 的 AspectJ 语 法 类 型 表达 式 ; 
implement-interface : 定义 需要 引入 的 接口 ; 


default-impl 和 delegate-ref : 定义 引入 接口 的 默认 实现 ， 二 者 选 一 ，default-impl 是 接口 的 默 
认 实 现 类 全 限定 名 ， 而 delegate-ref 是 默认 的 实现 的 委托 Bean 名 ; 


接 下 来 让 我 们 练习 一 下 吧 : 


首先 定义 引入 的 接口 及 默认 实现 : 


1. package cn.javass.spring.chapter6.service; 

2. public interface lIntroductionService { 

3. public void induct(); 

4. } 

1. package cn.javass.spring.chapter6.service.impl; 

2. import cn.javass.spring.chapter6.service.lIntroductionService; 
3. public class IntroductiondService implements llIntroductionService { 
4. @Override 

5. public void induct() { 

6. System.out.printIn("=========introduction"); 

7. } 

8. } 


其 次 在 chapter6/advice.xml 配 置 文件 中 接着 前 置 通知 配置 的 例子 添加 如 下 配置 : 


<aop:declare-parents 
types-matching="cn.javass.….IHelloWorldService+" 
implement-interface="cn.javass.spring.chapter6.service. lIntroductionService" 


入 DD 


default-impl="cn.javass.spring.chapter6.service.impl.IntroductiondService"/> 


最 后 测试 一 下 吧 ， 测 试 代码 cn.javass.spring.chapter6.AopTest : 


1. @Test 
2. public void testSchemalntroduction() { 
3. System.out.printIn("======================================"); 
4. ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml"); 
5. lIntroductionService introductionService = 
6. ctx.getBean("helloWorldService", lIntroductionService.class); 
7. introductionService.induct(); 
8. System.out.printIn("======================================"); 
9. } 
将 输入 
=========jntroduction 
分 析 一 下 吧 : 


1) 目标 对 象 类 型 匹配 : 使 用 types-matching="cn.javass..*.IHelloWorldService+" 匹 配 
lIHelloWorldService 接 口 的 子 类 型 ， 如 HelloWorldService 实 现 ; 


2) 引入 接口 定义 : 通过 implement-interface 属 性 表示 引入 的 接口 ， 
如 "cn.javass.spring.chapter6.service.llIntroductionService”。 


3) 引入 接口 的 实现 : 通过 default-impl 属 性 指定 ， 
如 “cn.javass.spring.chapter6.service.impl.IntroductiondService”， 也 可 以 使 用 “delegate-ref" 来 
指定 实现 的 Bean。 


4) 获取 引入 接口 : 如 使 用 “ctx.getBean("helloWorldService", IIntroductionService.class); "可 


直接 获取 到 引入 的 接口 。 


6.3.5 Advisor 


Advisor 表 示 只 有 一 个 通知 和 一 个 切入 点 的 切面 ， 由 于 Spring AOP 都 是 基于 AOP 联 盟 的 拦截 器 
模型 的 环绕 通知 的 ， 所 以 引入 Advisor 来 支持 各 种 通知 类 型 (如 前 置 通知 等 5 种 ) ，Advisor 概 
念 来 自 于 Spring1.2 对 AOP 的 支持 ， 在 AspectJ 中 没有 相应 的 概念 对 应 。 


A 


Advisor 可 以 使 用 <aop:config> 标 签 下 的 <aop:advisor> 标 签 定义 : 


1. <aop:advisor pointcut=" 切 入 点 表达 式 " pointcut-ref=" 切 入 点 Bean 引 用 " 
2. advice-ref=" 通 知 AP| 实 现 引 用 "/> 


pointcut 和 pointcut-ref : 二 者 选 一 ， 指 定 切入 点 表达 式 ; 

advice-ref : 引用 通知 API 实 现 Bean， 如 前 置 通知 接口 为 MethodBeforeAdvice ; 

接 下 来 让 我 们 看 一 下 示例 吧 : 

首先 在 cn.javass.spring.chapter6.service.lhelloWorldService 定 义 一 个 测试 方法 : 
1. public void sayAdvisorBefore(String param); 


其 次 在 cn.javass.spring.chapter6.service.impl. HelloWorldService 定 义 实现 


1. @Override 

2. public void sayAdvisorBefore(String param) { 

3. System.out.println("============Say "+ param); 
4. } 


第 三 定义 前 置 通知 API 实 现 : 


1. package cn.javass.spring.chapter6.aop; 

2. import java.lang.reflect.Method; 

3. import org.springframework.aop.MethodBeforeAdvice; 

4. public class BeforeAdvicelmpl implements MethodBeforeAdvice { 

5. @Override 

6. public void before(Method method, Object[] args, Object target) throws Throwable { 
7. System.out.printIn("===========before advice"); 

8. } 

9. } 


在 chapter6/advice.xml 配 置 文件 中 先 添 加 通知 实现 Bean 定 义 : 
1. <bean id="beforeAdvice" class="cn.javass.spring.chapter6.aop.BeforeAdvicelmpl"/> 
然后 在 <aop:config> 标 签 下 ， 添 加 Advisor 定 义 ， 添 加 时 注意 顺序 : 


1. <aop:advisor pointcut="execution( cn.javass...sayAdvisorBefore(..))" 
2. advice-ref="beforeAdvice"/> 


测试 代码 cn.javass.spring.chapter6.AopTest: 


1. @Test 
2. public void testSchemaAdvisor() { 


4. ApplicationContext ctx = new ClassPathXmlApplicationContext("chapter6/advice.xml”); 
5. |IHelloWorldService helloworldService = 

6. ctx.getBean("helloWorldService", IHelloWorldService.class); 

7. helloworldService.sayAdvisorBefore("haha"); 

8 

9 


在 此 我 们 只 介绍 了 前 置 通知 APl， 其 他 类 型 的 在 后 边 章 


避 

NV 

3 
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不 推荐 使 用 Advisor， 除 了 在 进行 事务 控制 的 情况 下 ， 其 他 情况 一 般 不 推荐 使 用 该 方式 ， 该 方 
式 属于 侵入 式 设 计 ， 必 须 实现 通知 AP|。 


【第 六 章 】AOP 之 6.4 基于 @AspectJ 的 AOP 
一 一 跟 我 学 spring3 


Spring 除了 支持 Schema 方式 配置 AOP， 还 支持 注解 方式 : 使 用 @AspectJ 风 格 的 切面 声明 。 

6.4.1 启用 对 @AspectJ 的 支持 

Spring 默认 不 支持 @AspectJ 风 格 的 切面 声明 ， 为 了 支持 需要 使 用 如 下 配置 
<aop:aspectj-autoproxy/> 

这 样 Spring 就 能 发 现 @AspectJ 风 格 的 切面 并 且 将 切面 应 用 到 目标 对 象 。 


6.4.2 声明 切面 
@AspectJ 风 格 的 声明 切面 非常 简单 ， 使 用 @Aspect 注 解 进行 声明 : 


@Aspect() 
Public class Aspect{ 


然后 将 该 切面 在 配置 文件 中 声明 为 Bean 后 ，Spring 就 能 自动 识别 并 进行 AOP 方 面 的 配置 : 


<bean id="aspect" class="....Aspect"/> 
该 切面 就 是 一 个 POJO， 可 以 在 该 切面 中 进行 切入 点 及 通知 定义 ， 接 着 往 下 看 吧 。 


6.4.3 声明 切入 点 


@AspectJ Be 切入 点 使 用 org.aspectj.lang.annotation 包 下 的 @Pointcut+ 方 法 (方法 必 
须 是 返回 void 类 型 ) 实现 。 


@Pojintcut(Value=" 切 入 点 表达 式 "，argNames = "参数 名 列表 " ) 
public void pointcutName(.…) 1 


value : 指定 切入 点 表达 式 ; 


te 指定 命名 切入 点 方法 参数 列表 参数 名 字 ， 可 以 有 多 个 用 “，” 分 隔 ， 这 些 参数 将 传 
给 通知 方法 同名 的 参数 ， 同 时 比如 切入 点 表达 式 “args(param)" 将 匹配 参数 类 型 为 命名 切入 
的 参数 类 型 。 


pointcutName : 切入 点 名 字 ， 可 以 使 用 该 名 字 进 行 引 用 该 切入 点 表达 式 。 


@Pointcut(value="execution(* cn.javass..*.sayAdvisorBefore(..)) && args(param)", argNames 
public void beforePointcut(String param) {} 


加 -了 








定义 了 一 个 切入 点 ， 名 字 为 beforePointcut”， 该 切入 点 将 匹配 目标 方法 的 第 一 个 参数 类 型 为 
通知 方法 实现 中 参数 名 为 <param” 的 参数 类 型 。 


6.4.4 声明 通知 
@AspectJ 风 格 的 声明 通知 也 支持 5 种 通知 类 型 : 
一 、 前 置 通知 : 使 用 org.aspectj.lang.annotation 包 下 的 @Before 注 解 声明 ; 


@Before(value = "切入 点 表达 式 或 命名 切入 点 "，argNames = "参数 列表 参数 名 " ) 


value : 指定 切入 点 表达 式 或 命名 切入 点 ; 

argNames : 与 Schema 方式 配置 中 的 同 义 。 

接 下 来 示例 一 下 吧 : 

1、 定 义 接口 和 实现 ， 在 此 我 们 就 使 用 Schema 风格 时 的 定义 ; 
2、 定 义 切 面 : 


package cn.javass.spring.chapter6.aop; 
Import org.aspectj.lang.annotation.Aspect ; 
@Aspect 

public class HelloworldAspect2 { 


} 


3、 定 义 切 入 点 : 


@Pointcut(value="execution(* cn.javass..*.sayAdvisorBefore(..)) && args(param)", argNames 
public void beforePointcut(String param) {} 


和 





4、 定 义 通知 : 


@Before(value = "beforePointcut(param)", argNames = "param") 
public void beforeAdvice(String param) { 

System.out.println("===========before advice param:" + param); 
} 


5、 在 chapter6/advice2.xml 配 置 文件 中 进行 如 下 配置 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> 


<aop:aspectj-autoproxy/> 
<bean id="helloworldService" 
class="cn.javass.spring.chapter6. service.impl.HelloworldService"/> 


<bean id="aspect" 
class="cn.javass.spring.chapter6.aop.HelloworldAspect2"/> 


</beans> 


6、 测 试 代 码 cn.javass.spring.chapter6.AopTest: 


@Test 

public void testAnnotationBeforeAdvice() { 
System.out.println("======================================" )， 
ApplicationContext ctx = new ClassPathxmlApplicationContext("chapter6/advice2.xml"); 
IHelloworldService helloworldService = ctx.getBean("helloworldService", IHelloworldSse 
helloworldService.sayBefore("before"); 
System.out.println("======================================" )， 





===========before advice param:before 


============Say before 


切面 、 切 入 点 、 通 知 全 部 使 用 注解 完成 : 
1) 使 用 @Aspect 将 POJO 声 明 为 切面 ; 


2) 使 用 @Pointcut 进 行 命名 切入 点 声明 ， 同 时 指定 目标 方法 第 一 个 参数 类 型 必须 是 
java.lang.String， 对 于 其 他 匹配 的 方法 但 参数 类 型 不 一 致 的 将 也 是 不 匹配 的 ， 通 过 argNames 
= "param" 指 定 了 将 把 该 匹配 的 目标 方法 参数 传递 给 通知 同名 的 参数 上 ; 


3) 使 用 @Before 进 通知 声明 ， 其 中 value 用 于 定义 切入 点 表达 式 或 引用 命名 切入 点 ; 
4) 配置 文件 需要 使 用 <aop:aspectj-autoproxy/> 来 开 尼 注解 风格 的 @AspectJ 支 持 ; 
5) 需要 将 切面 注册 为 Bean， 如 “aspect"Bean ; 


6) 测试 代码 完全 一 样 。 


二 、 后 置 返回 通知 : 使 用 org.aspectj.lang.annotation 包 下 的 @AfterReturning 注 解 声明 ; 


@AfterReturning( 

Value=" 切 入 点 表达 式 或 命名 切入 点 " 
pointcut=" 切 入 点 表达 式 或 命 2 en 
argNames=" 参 数列 表 参 数 名 "， 
returning=" 返 回 值 对 应 参数 名 3 


value : 指定 切入 点 表达 式 或 命名 切入 点 ; 


pointcut : 同样 是 指定 切入 点 表达 式 或 命名 切入 点 ， 如 果 指 定 了 将 覆盖 value 属 性 指定 的 ， 
pointcut 具 有 高 优先 级 ; 


argNames : 与 Schema 方式 配置 中 的 同 义 ; 
returning : 与 Schema 方式 配置 中 的 同 义 。 


@AfterReturning( 
value="execution(* cn.javass..*.sayBefore(..))", 
pointcut="execution(* cn.javass..*.sayAfterReturning(..))", 
argNames="retVal", returning="retVal") 
public void afterReturningAdvice(Object retVal) { 
System.out.println("===========after returning advice retVal:" + retVal); 
} 


其 中 测试 代码 与 Schema 方 式 几 乎 一 样 ， 在 此 就 不 演示 了 ， 如 果 需 要 请 参考 AopTest.java 中 的 
testAnnotationAfterReturningAdvice 测 试 方法 。 


三 、 后 置 异 常 通知 : 使 用 org.aspectj.lang.annotation 包 下 的 @AfterThrowing 注 解 声明 ; 


@AfterThrowing ( 

Value=" 切 入 点 表达 式 或 命名 切入 点 " 
pointcut=" 切 入 点 表达 式 或 命 De 起 二 
argNames=" 参 数列 表 参 数 名 "， 
throwing=" 弄 常 对 应 参数 名 ") 


value : 指定 切入 点 表达 式 或 命名 切入 点 ; 


pointcut : 同样 是 指定 切入 点 表达 式 或 命名 切入 点 ， 如 果 指 定 了 将 履 盖 value 属 性 指定 的 ， 
pointcut 具 有 高 优先 级 ; 


argNames : 与 Schema 方 式 配 置 中 的 同 义 ; 


throwing : 与 Schema 方式 配置 中 的 同 义 。 


@AfterThrowing( 
value="execution(* cn.javass..*.sayAfterThrowing(..))", 
argNames="exception", throwing="exception") 
public void afterThrowingAdvice(Exception exception) { 
System.out.println("===========after throwing advice exception:" + exception); 
} 


其 中 测试 代码 与 Schema 方式 几乎 一 样 ， 在 此 就 不 演示 了 ， 如 果 需 要 请 参考 AopTestjava 中 的 
testAnnotationAfterThrowingAdvice 测 试 方法 。 


四 、 后 置 最 终 通知 : 使 用 org.aspectj.lang.annotation 包 下 的 @After 注 解 声明 ; 


@After ( 
Value=" 切 入 点 表达 式 或 命名 切入 点 ""， 
argNames=" 参 数列 表 参 数 名 " ) 


value : 指定 切入 点 表达 式 或 命名 切入 点 ; 


argNames : 与 Schema 方式 配置 中 的 同 义 ; 


@After(value="execution(* cn.javass..*.sayAfterFinally(..))") 

public void afterFinallyAdvice() { 
System.out.println("===========after finally advice"); 

} 


其 中 测试 代码 与 Schema 方 式 几 乎 一 样 ， 在 此 就 不 演示 了 ， 如 果 需 要 请 参考 AopTest.java 中 的 
testAnnotationAfterFinallyAdvice 测 试 方法 。 


五 、 环 绕 通 知 : 使 用 org.aspectj.lang.annotation 包 下 的 @Around 注 解 声明 ; 


@Around ( 
Value=" 切 入 点 表达 式 或 命名 切入 点 ""， 
argNames=" 参 数列 表 参 数 名 " ) 


value : 指定 切入 点 表达 式 或 命名 切入 点 ; 
argNames : 与 Schema 方式 配置 中 的 同 义 ; 


@Around(value="execution(* cn.javass..*.sayAround(..))") 
public Object aroundAdvice(ProceedingJoinPoint pjp) throws Throwable { 


System.out.println("===========around before advice"); 
Object retVal = pjp.proceed(new Object[] {"replace"}); 
System.out.println("===========around after advice"); 


return retVal; 


其 中 测试 代码 与 Schema 方 式 几 乎 一 样 ， 在 此 就 不 演示 了 ， 如 果 需 要 请 参考 AopTest.java 中 的 
annotationAroundAdviceTest 测 试 方法 。 


6.4.5 引入 


@AspectJ 风 格 的 引入 声明 在 切面 中 使 用 org.aspectj.lang.annotation 包 下 的 @DeclareParents 
声明 : 


@DeclareParents( 

value=" AspectJ 语 法 类 型 表达 式 "， 
defaultImpl= 引 入 接口 的 默认 实现 类 ) 
private Interface interface; 


value : 匹配 需要 引入 接口 的 目标 对 象 的 AspectJ 语 法 类 型 表达 式 ; 与 Schema 方式 中 的 types- 
matching 属 性 同 义 ; 


private Interface interface : 指定 需要 引入 的 接口 ; 


defaultImpl : 指定 引入 接口 的 黑 认 实现 类 ， 没 有 与 Schema 方式 中 的 delegate-ref 属 性 同 义 的 定 
义 方式 ; 


@DeclareParents( 


value="cn.javass..*.IHelloworldService+", defaultIimpl=cn.javass.spring.chapter6.servi 
private IIntroductionService introductionService; 


图 = 





其 中 测试 代码 与 Schema 方式 几乎 一 样 ， 在 此 就 不 演示 了 ， 如 果 需 要 请 参考 AopTestjava 中 的 
testAnnotationlntroduction 测 试 方法 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2471.html] 


【第 六 章 】AOP 之 6.5 AspectJ 切 入 点 语法 详解 
一 一 跟 我 学 spring3 


6.5.1 Spring AOP 支 持 的 AspectJ 切 入 点 指示 符 


切入 点 指示 符 用 来 指示 切入 点 表达 式 目 的 ，， 在 Spring AOP 中 目前 只 有 执行 方法 这 一 个 连接 
点 ，Spring AOP 支 持 的 AspectJ 切 入 点 指示 符 如 下 : 


execution : 用 于 匹配 方法 执行 的 连接 点 ; 
within : 用 于 匹配 指定 类 型 内 的 方法 执行 ; 


this : 用 于 匹配 当前 AOP 代 理 对 象 类 型 的 执行 方法 ; 注意 是 AOP 代 理 对 象 的 类 型 匹配， 这样 
就 可 能 包括 引入 接口 也 类 型 匹配 ; 


target : 用 于 匹配 当前 目标 对 象 类 型 的 执行 方法 ; 注意 是 目标 对 象 的 类 型 匹配 ， 这 样 就 不 包括 
引入 接口 也 类 型 匹配 ; 


args : 用 于 匹配 当前 执行 的 方法 传 入 的 参数 为 指定 类 型 的 执行 方法 ; 

@within : 用 于 匹配 所 以 持 有 指定 注解 类 型 内 的 方法 ; 

@target : 用 于 匹配 当前 目标 对 象 类 型 的 执行 方法 ， 其 中 目标 对 象 持 有 指定 的 注解 ; 
@args : 用 于 匹配 当前 执行 的 方法 传 入 的 参数 持 有 指定 注解 的 执行 ; 

@annotation : 用 于 匹配 当前 执行 方法 持 有 指定 注解 的 方法 ; 


bean : Spring AOP 扩 展 的 ，Aspecty 没 有 对 于 指示 符 ， 用 于 匹配 特定 名 称 的 Beanm_ 对象 的 执 
行 方法 ; 


reference pointcut : 表示 引用 其 他 命名 切入 点 ， 只 有 @ApectJ 风 格 支持 ，Schema 风 格 不 支 
持 。 


AspectJ 切 入 点 支持 的 切入 点 指示 符 还 有 : call、get、set、preinitialization、 
staticinitialization 、 initialization、handler、adviceexecution、withincode、cflow、 
cflowbelow、if、@this、@withincode ; 但 Spring AOP 目 前 不 支持 这 些 指示 符 ， 使 用 这 些 指 
示 符 将 抛 出 llegalArgumentException 异 常 。 这 些 指 示 符 Spring AOP 可 能 会 在 以 后 进行 扩展 。 


6.5.1 命名 及 匿名 切入 点 
命名 切入 点 可 以 被 其 他 切入 点 引用 ， 而 匿名 切入 点 是 不 可 以 的 。 


只 有 人 @AspectJ 支 持 命名 切入 点 ， 而 Schema 风格 不 支持 命名 切入 点 。 


跟 我 学 Spring 系列 


如 下 所 示 ，@AspectJ 使 用 如 下 方式 引用 命名 切入 点 : 


(QPomteut(+ 


value="execution(* cn.jJavass.. .sayBefore(Java.lang.Strng)) && args(param)", « 


argNames = "param")+ 
public void a param) {}« 


引用 命名 切入 点 。 
(QBefore(value = "beforePomtcut(param)", areNames = "param")e 
public vold before Advice(Strng param) {+ 
Systemoutprmntlnf( "一 一 一 一 一 一 before advice param:" + param):+ 





}e 


6.5.2 ; 类 型 匹配 语法 
首先 让 我 们 来 了 解 下 AspectJ 类 型 匹配 的 通配符 : 
。 : 匹配 任何 数量 字符 ; 


(两 个 点 ) 匹配 任何 数量 字符 的 重复 ， 如 在 类 型 模式 中 匹配 任何 数量 子 包 ; 而 在 方法 参数 
模式 中 匹配 任何 数量 参数 。 


+ : 匹配 指定 类 型 的 子 类 型 ; 仅 能 作为 后 级 放 在 类 型 模式 后 边 。 
java.lang.String 匹配 String 类 型 ; 


java.*.String 匹配 java 包 下 的 任何 “一 级 子 包 ”下 的 String 类 型 ; 

如 匹配 java.lang.String， 但 不 匹配 java.lang.ss.String 
java..* 匹配 java 包 及 任何 子 包 下 的 任何 类 型 ; 

如 匹配 java.lang.String、java.lang.annotation.Annotation 
java.lang.*ing 匹配 任何 java.lang 包 下 的 以 ing 结 尾 的 类 型 ; 
java.lang.Number+ 匹配 java.lang 包 下 的 任何 Number 的 自 类 型 ; 


如 匹配 java.lang.Integer， 也 匹配 java.math .BigInteger 


接 下 来 再 看 一 下 具体 的 匹配 表达 式 类 型 吧 : 


匹配 类 型 : 使 用 如 下 方式 匹配 


、 五 、 
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注解 ? 类 的 全 限定 名 字 


e 注解 : 可 选 ， 类 型 上 持 有 的 注解 ， 如 @Deprecated ; 
e。 类 的 全 限定 名 : 必 卉 ， 可 以 是 任何 类 全 限定 名 。 


匹配 方法 执行 : 使 用 如 下 方式 匹配 : 


注解 ? 修饰 符 ? 返回 值 类 型 类 型 声明 ?方法 名 (参数 列表 ) 异常 列表 ? 


e。 注解 : 可 选 ， 方 法 上 持 有 的 注解 ， 如 @Deprecated ; 

。 修饰 符 : 可 选 ， 如 public、protected ; 

e@ 返回 值 类 型 : 必 卉 ， 可 以 是 任何 类 型 模式 ; “表示 所 有 类 型 ; 

e 类 型 声明 : 可 选 ， 可 以 是 任何 类 型 模式 ; 

e 方法 名 : 必 填 ， 可 以 使 用 “进行 模式 匹配 ; 

。 参数 列表 :“() "表示 方法 没有 任何 参数 ;“(..) 表示 匹配 接受 任意 个 参数 的 方 
法 ，“(..java.lang.String)” 表 示 匹 配 接受 java.lang.String 类 型 的 参数 结束 ， 且 其 前 边 可 以 接 
受 有 任意 个 参数 的 方法 ; “(java.lang.String,..)” 表 示 匹 配 接受 java.lang.String 类 型 的 参数 
开始 ， 且 其 后 边 可 以 接受 任意 个 参数 的 方法 ;“(*,java.lang.String》” 表示 匹配 接受 
java.lang.String 类 型 的 参数 结束 ， 且 其 前 边 接受 有 一 个 任意 类 型 参数 的 方法 ; 

。 异常 列表 : 可 选 ， 以 “throws 异常 全 限定 名 列表 "声明 ， 异 常 全 限定 名 列表 如 有 多 个 
以 “，" 分 割 ， 如 throws java.lang.legalArgumentException， 
java.lang.ArraylndexOutOfBoundsException 。 


匹配 Bean 名 称 : 可 以 使 用 Bean 的 id 或 hame 进 行 匹 配 ， 并 且 可 使 用 通配符 “*”; 
6.5.3 组 合 切 入 点 表达 式 


AspectJ 使 用 且 (&&) 、 或 (||) 、 非 (1! ) 来 组 合 切 入 点 表达 式 。 


在 Schema 风格 下 ， 由 于 在 XML 中 使 用 "&8&" 需 要 使 用 转 义 字 符 "&8&" 来 代替 之 ， 所 以 很 不 方便 ， 
因此 Spring ASP 提供 了 and、or、not 来 代替 &&、|、!。 


6.5.4 切入 点 使 用 示例 


一 、execution : 使 用 “execution( 方 法 表达 式 ) 匹配 方法 执行 ; 


模式 描述 
public (..) 任何 公共 方法 的 执行 
[2 3 6] 9 a 
cn.javass..IlPointcutService.() 区 包 及 所 有 子 包 下 IPointcutService 接 吕 
串 雹 ‘ 


cn.javass...*(..) cn.javass 包 及 所 有 子 包 下 任何 类 的 任何 方法 


cm.javass../PontcutsService.() 


(cnJavass..IPontcutService+).(..) 


cn.javass..lPointcutServicet+.() 


cn.javass..lPointcut.test*(java.util.Date) 


cn.javass..lPointcut.test*(..) throws 
lllegalArgumentException, 
ArraylndexOutOfBoundsException 


(cn.javass..IlPointcutService+&& 
Java.io. Serializable+).(..) 


@java.lang.Deprecated (..) 


@java.lang.Deprecated 
@cn.javass..Secure (..) 


@(java.lang.Deprecated || 
cn.javass..Secure) (..) 


(@cn.javass..Secure ) (..) 


(@cn.javass..Secure ).*(..) 


(@cn.javass..Secure () ， 
@cn.javass..Secure ()) 


((@ cn.javass..Secure )) 或 (@ 


cn.javass..Secure ) 


(@cn.javass..Secure 
(@cn.javass..Secure ) ,@ 
cn.javass..Secure (@cn.javass..Secure 


)) 


(java.util.Map<cn.javass..Model, 
cn.javass..Model>, ..) 


cn.javass 包 及 所 有 子 包 下 |PointcutService 接 口 
有 一 个 参数 方法 


非 “cn.javass 包 及 所 有 子 包 下 IPointcutService 接 
型 "的 任何 方法 


cn.javass 包 及 所 有 子 包 下 |PointcutService 接 口 
的 的 任何 无 参 方法 


cnjavass 包 及 所 有 子 包 下 IPointcut 前 组 类 型 的 下 
头 的 只 有 一 个 参数 类 型 为 java.util.Date 的 方法 ， 
配 是 根据 方法 签名 的 参数 类 型 进行 匹配 的 ， 而 了 
执行 时 传 入 的 参数 类 型 决定 的 如 定义 方法 : puk 
test(Object obj); 即 使 执行 时 传 入 java.util.Date ， 
配 的 ; 


cn.javass 包 及 所 有 子 包 下 IPointcut 前 组 类 型 的 
法 ， 且 抛 出 lllegalArgumentException 和 
ArraylndexOutOfBoundsException 异 常 


任何 实现 了 cn.javass 包 及 所 有 子 包 下 |Pointcuts 
口 和 java.io.Serializable 接 口 的 类 型 的 任何 方法 


任何 持 有 @java.lang.Deprecated 注 解 的 方法 


任何 持 有 @java.lang.Deprecated 和 人 @cn.javass 
注解 的 方法 


任何 持 有 @java.lang.Deprecated 或 @ cnjavas: 
注解 的 方法 


任何 返回 值 类 型 持 有 @cnjavass..Secure 的 方 沪 
任何 定义 方法 的 类 型 持 有 @cnjjavass..Secureg 


任何 签名 带 有 两 个 参数 的 方法 ， 且 这 个 两 个 参 疼 
Secure 标 记 了 ， 如 public void test(@Secure St 
@Secure String str1); 


任何 带 有 一 个 参数 的 方法 ， 且 该 参数 类 型 持 有 人 
cn.javass..Secure ; 如 public void test(Model m 
Model 类 上 持 有 @Secure 注 解 


任何 带 有 两 个 参数 的 方法 ， 且 这 两 个 参数 都 被 人 
cn.javass..Secure 标 记 了 ; 且 这 两 个 参数 的 类 型 
@ cn.javass..Secure ; 


任何 带 有 一 个 java.util.Map 参 数 的 方法 ， 且 该 参 
以 < cn.javass..Model, cn.javass..Model > 为 泛 3 
注意 只 匹配 第 一 个 参数 为 java.util.Map, 不 包括 于 
public void test(Hash Map<Model, Model> map 
Str); 将 不 匹配 ， 必 须 使 用 " 
(java.util.HashMap<cn.javass..Model,cn.javas:s 
..) 进行 匹配 ; 而 public void test(Map map, int i 
匹配 ， 因 为 泛 型 参数 不 匹配 


任何 带 有 一 个 参数 (类 型 为 java.util.Collection) 


法 ， 且 该 参数 类 型 是 有 一 个 泛 型 参数 ， 该 泛 型 各 
上 持 有 @cn.javass..Secure 注 解 ; 如 public void 
test(Collection<Model> collection);Model 类 型 
@cn.javass..Secure 


任何 带 有 一 个 参数 的 方法 ， 且 传 入 的 参数 类 型 
(java.util.Set<? extends HashMap>) 泛 型 参数 ， 该 泛 型 参数 类 型 继承 与 HashMap ; : 
AOP 目 前 测试 不 能 正常 工作 


任何 带 有 一 个 参数 的 方法 ， 且 传 入 的 参数 类 型 
泛 型 参数 ， 该 泛 型 参数 类 型 是 HashMap 的 基 类 : 
public voi test(Map map) ; Spring AOP 目 前 测 
常 工作 


任何 带 有 一 个 参数 的 方法 ， 且 该 参数 类 型 是 有 - 


(<@cn.javass..Secure >) 参数 ， 该 泛 型 参数 类 型 上 持 有 @cn.javass..Sec 
Spring AOP 目 前 测试 不 能 正常 工作 


(java.util.Collection<@cn.javass..Secure 
*>) 


(java.util.List<? super HashMap>) 


二 、within : 使 用 “within( 类 型 表达 式 )” 匹 配 指 定 类 型 内 的 方法 执行 ; 


模式 描述 
within(cn.javass..*) cn.javass 包 及 子 包 下 的 任何 方法 执行 
i . , | cn.javass 包 或 所 有 子 包 下 IPointcutService 类 型 及 
within(cn.javass..IPointcutService+) 子 类 型 的 任何 方法 
持 有 cn.javass..Secure 注 解 的 任何 类 型 的 任何 方 
within(@cn.javass..Secure *) 法 必须 是 在 目标 对 象 上 声明 这 个 注解 ， 在 接口 上 
声明 的 对 它 不 起 作用 


三 、this : 使 用 “this( 类 型 全 限定 名 )” 匹 配 当 前 AOP 代 理 对 象 类 型 的 执行 方法 ; 注意 是 AOP 代 
理 对 象 的 类 型 匹配 ， 这 样 就 可 能 包括 引入 接口 方法 也 可 以 匹配 ; 注意 this ”中 使 用 的 表达 式 必 
须 是 类 型 全 限定 名 ， 不 支持 通配符 ; 


模式 省 这 
当前 AOP 对 象 实现 了 
this(cn.javass.spring.chapter6.service.IPointcutService) IPointcutService 接 口 的 任 
何方 法 


当前 AOP 对 象 实现 了 
lIntroductionService 接 口 
的 任何 方法 也 可 能 是 引入 
接口 


this(cn.javass.spring.chapter6.service.lIntroductionService) 


四 、target : 使 用 “target( 类 型 全 限定 名 )” 匹 配 当 前 目标 对 得 类 型 的 执行 方法 ; 注意 是 目标 对 
象 的 类 型 匹配 ， 这 样 就 不 包括 引入 接口 也 类 型 匹配 ; 注意 target ”中 使 用 的 表达 式 必须 是 类 型 
全 限定 名 ， 不 支持 通配符 ; 


楼 式 过 


当前 目标 对 象 ( 非 AOP 
对 象 ) 实现 了 
IPointcutService 接 口 的 
任何 方法 


当前 目标 对 象 〈 非 AOP 
对 象 ) 实现 了 

target(cn.javass.spring.chapter6.service.lIntroductionService) ”lintroductionService 接 
口 的 任何 方法 不 可 能 是 
引入 接口 


target(cn.javass.spring.chapter6.service.IPointcutService) 


五 、args : 使 用 “grgs( 参 数 类 型 列表 )” 匹 配 当 前 执行 的 方法 传 入 的 参数 为 指定 类 型 的 执行 方 
法 ; 注意 是 匹配 传 入 的 参数 类 型 ， 不 是 匹配 方法 签名 的 参数 类 型 ; 参数 类 型 列表 中 的 参数 必 
须 是 类 型 全 限定 名 ， 通 配 符 不 支持 ; a1gs “属于 动态 切入 点 ， 这 种 切入 点 开销 非常 大 ， 非 特 
殊 情 况 最 好 不 要 使 用 ; 
模式 首 述 

任何 一 个 以 接受 " 传 入 参数 类 型 为 java.io.Serializable” 开头 ， 且 


其 后 可 跟 任意 个 任意 类 型 的 参数 的 方法 执行 ，args 指 定 的 参数 
类 型 是 在 运行 时 动态 匹配 的 


args 
(java.io. Serializable,..) 


六 、@within : 使 用 “@within( 注 解 类 型 ) ”匹配 所 以 持 有 指定 注解 类 型 内 的 方法 ; 注解 类 型 
也 必须 是 全 限定 类 型 名 ; 
模式 描述 

任何 目标 对 象 对 应 的 美 型 持 有 Secure 注 解 的 类 方 


法 ; 必须 是 在 目标 对 象 上 声明 这 个 注解 ， 在 接口 上 
声明 的 对 它 不 起 作用 


@within 
cn.javass.spring.chapter6.Secure) 


七 、@target : 使 用 “@target( 注 解 类 型 ) "匹配 当前 目标 对 象 类 型 的 执行 方法 ， 其 中 目标 对 象 
持 有 指定 的 注解 ; 注解 类 型 也 必须 是 全 限定 类 型 名 ; 


模式 描述 
@target 任何 目标 对 象 持 有 Secure 注 解 的 类 方法 ; 必须 是 
在 目标 对 象 上 声明 这 个 注解 ， 在 接口 上 声明 的 对 它 


(cn.javass.spring.chapter6.Secure) 不 起 作用 


入 、@args : 使 用 “@args( 注 解 列表 ) ”匹配 当前 执行 的 方法 传 入 的 参数 持 有 指定 注解 的 执 
行 ; 注解 类 型 也 必须 是 全 限定 类 型 名 ; 


模式 描述 
任何 一 个 只 接受 一 个 参数 的 方法 ， 且 方法 运行 时 传 
@args 入 的 参数 持 有 注解 


(cn.javass.spring.chapter6.Secure) ， cn.javass.spring.chapter6.Secure ; 动态 切入 点 ， 
类 似 于 arg 指 示 符 ; 


九 、@annotation : 使 用 “@annotation( 注 解 类 型 ) ”匹配 当前 执行 方法 持 有 指定 注解 的 方 
法 ; 注解 类 型 也 必须 是 全 限定 类 型 名 ; 
模式 描述 
@annotation(cn.javass.spring.chapter6.Secure 而 要 和 广 法 二 特有 注册 


) cn.javass.spring.chapter6.Secure 将 
被 匹配 


十 、bean : 使 用 “bean(Bean id 或 名 字 通 配 符 )” 匹 配 特 定名 称 的 Bean 对 象 的 执行 方 
法 ; Spring ASP 扩 展 的 ， 在 AspectJ 中 无 相应 概念 ; 


模式 描述 
bean(*Service) 匹配 所 有 以 Service 命 名 (id 或 hame) 结尾 的 Bean 


十 一 、reference pointcut : 表示 引用 其 他 命名 切入 点 ， 只 有 @ApectJ 风 格 支持 ，Schema 风 
格 不 支持 ， 如 下 所 示 : 


(QPomteut(value="bean(* Service)")+ 
private vold pointeutl 0{ } i 命名 切入 点 1+ 


(QPomteut(value=" (Qargs(cn.Javass. spring. chapter6. Secur jf 命 名 切入 点 24 


piivate vold pomnteut20{ }. 
(QBefore(value = "pomteutlO| &e& pomteut20") /3 引用 命名 切入 点 
public vold referencePoimmtcutTestl(JoinPomt jp) {« 

ump("pomteutl() && pomteut20", jp):+ 





比如 我 们 定义 如 下 切面 : 


package cn.javass.spring.chapter6.aop; 

Import org.aspectj.lang.annotation.Aspect ; 

import org.aspectj.lang.annotation.Pointcut; 

@Aspect 

public class ReferencePointcutAspect { 
@Pointcut(value="execution(* *())") 
public void pointcut() {} 


可 以 通过 如 下 方式 引用 : 


@Before(value = "cn.javass.spring.chapter6.aop.ReferencePointcutAspect.pointcut()") 
public void referencePointcutTest2(JoinPoint jp) {} 


除了 可 以 在 @AspectJ 风 格 的 切面 内 引用 外 ， 也 可 以 在 Schema 风格 的 切面 定义 内 引用 ， 引 用 
方式 与 @AspectJ 完 全 一 样 。 


到 此 我 们 切入 点 表达 式 语 法 示例 就 介绍 完了 ， 我 们 这 些 示 例 几 乎 包含 了 日 常 开发 中 的 所 有 情 
况 ， 但 当然 还 有 更 复杂 的 语法 等 等 ， 如 果 以 上 介绍 的 不 能 满足 您 的 需要 ， 请 参考 AspectJ 文 
档 。 


由 于 测试 代码 相当 长 ， 所 以 为 了 节约 篇 幅 本 示例 代码 在 cn.javass.spring.chapter6. 
PointcutTest 文 件 中 ， 需 要 时 请 参考 该 文件 。 


原创 内 容 ， 转 自 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2472.html] 


NS 


【第 六 章 】 AOP 之 6.6 通知 参数 一 一 跟 我 学 
spring3 


前 边 章 节 已 经 介绍 了 声明 通知 ， 但 如 果 想 获取 被 被 通知 方法 参数 并 传递 给 通知 方法 ， 该 如 何 


实现 呢 ? 接 下 来 我 们 将 介绍 两 种 获取 通知 参数 的 方式 。 


。 使 用 JoinPoint 获 取 : Spring AOP 提 供 使 用 org.aspectj.lang.JoinPoint 类 型 获取 连接 点 数 
据 ， 任 何 通知 方法 的 第 一 个 参数 都 可 以 是 JoinPoint( 环 绕 通 知 是 ProceedingJoinPoint ， 
JoinPoint 子 类 )， 当 然 第 一 个 参数 位 置 也 可 以 是 JoinPoint.StaticPart 类 型 ， 这 个 只 返回 连 


接点 的 静态 部 分 。 
1) JoinPoint : 提供 访问 当前 被 通知 方法 的 目标 对 象 、 代 理 对 象 、 方 法 参数 等 数据 : 


package org.aspectj.1ang; 
import org.aspectj.1lang.reflect.SourceLocation,; 
public interface JoinPoint { 


String toString(); // 连 接点 所 在 位 置 的 相关 信息 
String toShortstring(); // 连 接点 所 在 位 置 的 简短 相关 信息 
String toLongstring(); // 连 接点 所 在 位 置 的 全 部 相关 信息 
Object getThis(); // 返 回 AOP 代 理 对 象 

Object getTarget(); // 返 回 目标 对 象 

Object[] getArgs(); // 返 回 被 通知 方法 参数 列表 


Signature getSignature(); // 返 回 当前 连接 点 签名 

SourceLocation getSourceLocation();// 返 回 连接 点 方法 所 在 类 文件 中 的 位 置 
String getKind() ; // 连 接点 类 型 

StaticPart getStaticPart(); // 返 回 连接 点 静态 部 分 


2) ProceedingJoinPoint : 用 于 环绕 通知 ， 使 用 proceed() 方 法 来 执行 目标 方法 : 


public interface ProceedingJoinPoint extends JoinPoint { 
public Object proceed() throws Throwable 
public Object proceed(Object[] args) throws Throwable; 


3) JoinPoint.StaticPart : 提供 访问 连接 点 的 静态 部 分 ， 如 被 通知 方法 签名 、 连 接点 类 型 


public interface StaticPart { 


Signature getSignature(); // 返 回 当前 连接 点 签名 

String getkind(); // 连 接点 类 型 

int getId(); /7 叭 二 标识 

String toString(); // 连 接点 所 在 位 置 的 相关 信息 
String toShortstring(); // 连 接点 所 在 位 置 的 简短 相关 信息 
String toLongstring(); // 连 接点 所 在 位 置 的 全 部 相关 信息 


使 用 如 下 方式 在 通知 方法 上 声明 ， 必 须 是 在 第 一 个 参数 ， 然 后 使 用 jp.getArgs() 就 能 获取 到 被 


通知 方法 参数 : 


@Before(value="execution(* sayBefore(*))") 
public void before(JoinPoint jp) 人 


@Before(value="execution(* sayBefore(*))") 
public void before(JoinPoint .StaticPart jp) 人 


e 自动 获取 : 通过 切入 点 表达 式 可 以 将 相应 的 参数 自动 传递 给 通知 方法 ， 例 如 前 边 章节 讲 
过 的 返回 值 和 异常 是 如 何 传 递 给 通知 方法 的 。 
在 Spring AOP 中 ， 除 了 execution 和 bean 指 示 符 不 能 传递 参数 给 通知 方法 ， 其 他 指示 符 都 可 以 


将 匹配 的 相应 参数 或 对 象 自动 传递 给 通知 方法 。 


@Before(value="execution(* test(*)) && args(param)", argNames="param") 
public void beforei(String param) { 

System.out.println("===param:" + param); 
} 


切入 点 表达 式 execution( test()) && args(param) : 
1) 首先 execution( test()) 匹 配 任何 方法 名 为 test， 且 有 一 个 任何 类 型 的 参数 ; 


2) args(param) 将 首先 查找 通知 方法 上 同名 的 参数 ， 并 在 方法 执行 时 (运行 时 ) 匹配 传 入 的 
参数 是 使 用 该 同名 参数 类 型 ， 即 java.lang.String ; 如 果 匹 配 将 把 该 被 通知 参数 传递 给 通知 方法 
上 同名 参数 。 


其 他 指示 符 (除了 execution 和 bean 指 示 符 ) 都 可 以 使 用 这 种 方式 进行 参数 绑 定 。 


在 此 有 一 个 问题 ， 即 前 边 提 到 的 类 似 于 【3.1.2 构 造 器 注入 】 中 的 参数 名 注入 限制 : 在 class 文 
件 中 没 生成 变量 调试 信息 是 获取 不 到 方法 参数 名 字 的 。 
所 以 我 们 可 以 使 用 策略 来 确定 参数 名 : 


1、 如 果 我 们 通过 “argNames”" 属 性 指定 了 参数 名 ， 那 么 就 是 要 我 们 指定 的 ; 


@Before(value=" args(param)"，argNames="param" ) // 明 确 指定 了 

public void beforei(String param) { 
System.out.println("===param:" + param); 

} 


2、 如 果 第 一 个 参数 类 型 是 JoinPoint、ProceedingJoinPoint 或 JoinPoint.StaticPart 类 型 ， 应 该 
从 "argNames" 属 性 省 略 掉 该 参数 名 (可 选 ， 写 上 也 对 ) ， 这 些 类 型 对 象 会 自动 传 入 的 ， 但 必 
须 作 为 第 一 个 参数 ; 


@Before(value=" args(param)"，argNames="param" ) // 明 确 指定 了 

public void before1(JoinPoint jp, String param) { 
System.out.println("===param:" + param); 

} 


3、 如 果 “class 文 件 中 含有 变量 调试 信息 "将 使 用 这 些 方 法 签名 中 的 参数 名 来 确定 参数 名 ; 


@Before(value=" args(param)") // 不 需要 argNames 了 
public void before1(JoinPoint jp, String param) { 
System.out.println("===param:" + param); 

} 


4、 如 果 没 有 "class 文件 中 含有 变量 调试 信息 ”， 将 尝试 自己 的 参数 匹配 算法 ， 如 果 发 现 参数 绑 
定 有 二 义 性 将 抛 出 AmbiguousBindingException 异 常 ; 对 于 只 有 一 个 绑 定 变量 的 切入 点 表达 
式 ， 而 通知 方法 只 接受 一 个 参数 ， 说 明 绑 定 参 数 是 明确 的 ， 从 而 能 配对 成 功 。 


@Before(value=" args(param)") 

public void before1(JoinPoint jp, String param) { 
System.out.println("===param:" + param); 

} 


5、 以 上 策略 失败 将 抛 出 lllegalArgumentException。 


接 下 来 让 我 们 示例 一 下 组 合 情 况 吧 : 


@Before(args(param) && target(bean) && @annotation(secure)", 
argNames="jp,param, bean, secure") 
public void before5(JoinPoint jp, String param, 
IPointcutService pointcutService, Secure secure) { 


该 示例 的 执行 步骤 如 图 6-5 所 示 。 


切入 点 表达 式 及 通知 方法 






2. 1、 运 行 时 匹配 参数 洲 


java.lang .Stringd 






3 将 匹配 的 参数 传 
递 给 同名 通知 方法 








被 通知 方法 调用 





annotationtse cufe) 二 ] ~ 


Eervice .testf' Parameter') : 





2. 2、 运 行 时 匹配 目标 对 
象 洲 IPolntcutServwice 








JoinPoint jp, 
String paratn, 

IPointcutS ervice = ErY1iCE, 
SECUrE SECUTE 


被 通知 方法 声明 2. 3 运行 时 匹配 执行 的 方 
法 持 有 Secute 往 解 






ublic boolean test{({Object ob]) : 


图 6-5 参数 自动 获取 流程 


除了 上 边 介 绍 的 普通 方式 ， 也 可 以 对 使 用 命名 切入 点 自动 获取 参数 : 


@Pointcut(value="args(param)", argNames="param") 

private void pointcut1(String param){} 
@Pointcut(value="@annotation(secure)", argNames="secure") 
private void pointcut2(Secure secure){} 


@Before(value = "pointcuti(param) && pointcut2(secure)", 


argNames="param, secure") 
public void before6(JoinPoint jp, String param, Secure secure) { 


自 此 给 通知 传递 参数 已 经 介绍 完了 ， 示 例 代 码 在 cn.javass.spring.chapter6.ParameterTest 文 
件 中 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2473.html] 


【第 六 章 】 AOP 之 6.7 通知 顺序 一 一 跟 我 学 
spring3 
如 果 我 们 有 多 个 通知 想 要 在 同一 连接 点 执行 ， 那 执行 顺序 如 何 确定 呢 ? Spring AOP 使 用 


AspectJ 的 优先 级 规则 来 确定 通知 执行 顺序 。 总 共有 两 种 情况 : 同一 切面 中 通知 执行 顺序 、 不 
同 切面 中 的 通知 执行 顺序 。 


首先 让 我 们 看 下 


1) 同一 切面 中 通知 执行 顺序 : 如 图 6-6 所 示 。 


、 前 置 通知 /环绕 通知 (proceed 方 法 执行 之 前 ) 一 执行 顺序 不 确定 


、 后 置 通知 /环绕 通知 (proceed 之 后 ) -一 执行 顺序 不 确定 





图 6-6 同一 切面 中 的 通知 执行 顺序 


而 如 果 在 同一 切面 中 定义 两 个 相同 类 型 通知 (如 同 是 前 置 通知 或 环绕 通知 (proceed 之 前 ) ) 
并 在 同一 连接 点 执行 时 ， 其 执行 顺序 是 未 知 的 ， 如 果 确 实 需 要 指定 执行 顺序 需要 将 通知 重 构 
到 两 个 切面 ， 然 后 定义 切面 的 执行 顺序 。 


错误 “Advice precedence circularity error” :说 明 AspectJ 无 法 决定 通知 的 执行 顺序 ， 只 要 将 通知 方法 分 类 并 
图 


2) 不 同 切面 中 的 通知 执行 顺序 : 当 定 义 在 不 同 切面 的 相同 类 型 的 通知 需要 在 同一 个 连接 点 执 
行 ， 如 果 没 指定 切面 的 执行 顺序 ， 这 两 个 通知 的 执行 顺序 将 是 未 知 的 。 





如 果 需 要 他 们 顺序 执行 ， 可 以 通过 指定 切面 的 优先 级 来 控制 通知 的 执行 顺序 。 


Spring 中 可 以 通过 在 切面 实现 类 上 实现 org.springframework.core.Ordered 接 口 或 使 用 Order 注 
解 来 指定 切面 优先 级 。 在 多 个 切面 中 ，Ordered.getValue() 方 法 返回 值 (或 者 注解 值 ) 较 小 值 
的 那个 切面 拥有 较 高 优先 级 ， 如 图 6-7 所 示 。 


Aspectl( order:1) 





1、 前 置 通知 /环绕 通知 (proceed 访 法 执行 之 前 ) 最 终 执行 顺序 {order 较 小 值 拥有 较 高 忧 先 级 ) 
、 被 通知 方法 、 丰 spect1 前 置 通知 /环绕 通知 (proceed 方 法 执行 之 前 ) 
B、 后 置 通知 /环绕 通知 (proceed 之 后 ) 、 上 shect2 前 置 通知 /环绕 通知 (proceed 访 法 执行 之 前 ) 
、 被 通知 方法 

、 各 spect2. 后 置 通知 /环绕 通知 (proceed 之 后 ) 

、 上 spedtl .后 置 通 知 / 环 绕 通知 (proceed 之 后 ) 


Aspect2( order:2) 





、 后 置 通知 /环绕 通知 (procee 入 后 ) 一 .一 .| 一. | 


图 6-7 两 个 切面 指定 了 优先 级 


对 于 @AspectJ 风 格 和 注解 风格 可 分 别 用 以 下 形式 指定 优先 级 : 


CAspectr =aop:aspect ref="aspectl" ordel="1=。 


(Order(2). sy 


public class OrderAspect2 {+ =/aop:aspect=+ 





在 此 我 们 不 推荐 使 用 实现 Ordered 接 口 方 法 ， 所 以 没 介绍 ， 示 例 代码 在 
cn.javass.spring.chapter6. OrderAopTest 文 件 中 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2474.html] 


【第 六 章 】AOP 之 6.8 切面 实例 化 模型 一 跟 我 
学 spring3 


所 谓 切 面 实例 化 模型 指 何 时 实例 化 切面 。 


Spring AOP 支 持 AspectJ 的 singleton、perthis、pertarget 实 例 化 模型 (目前 不 支持 percflow 、 
percflowbelow 和 pertypewithin) 。 


。 singleton : 即 切面 只 会 有 一 个 实例 ; 

。 perthis : 每 个 切入 点 表达 式 匹 配 的 连接 点 对 应 的 AOP 对 象 都 会 创建 一 个 新 切面 实例 ; 

。 pertarget : 每 个 切入 点 表达 式 匹配 的 连接 点 对 应 的 目标 对 象 都 会 创建 一 个 新 的 切面 实 
例 ; 


默认 是 singleton 实 例 化 模型 ，Schema 风 格 只 支持 singleton 实 例 化 模型 ， 而 @AspectJ 风 格 支 
持 这 三 种 实例 化 模型 。 


singleton : 使 用 @Aspect() 指 定 ， 即 默认 就 是 单 例 实例 化 模式 ， 在 此 就 不 演示 示例 了 。 


perthis : 每 个 切入 点 表达 式 匹配 的 连接 点 对 应 的 AOP 对 象 都 会 创建 一 个 新 的 切面 实例 ， 使 用 
@Aspect("perthis( 切 入 点 表达 式 )") 指 定 切 入 点 表达 式 ; 


如 @Aspect("perthis(this(cn.javass.spring.chapter6.service.lIntroductionService))") 将 对 每 个 
匹配 “this(cn.javass.spring.chapter6.service.lintroductionService)" 切 入 点 表达 式 的 AOP 代 理 对 
象 创建 一 个 切面 实例 ， 注 意 "|IntroductionService” 可 能 是 引入 接口 。 


pertarget : 每 个 切入 点 表达 式 匹配 的 连接 点 对 应 的 目标 对 象 都 会 创建 一 个 新 的 切面 实例 ， 使 
用 @Aspect("pertarget( 切 入 点 表达 式 )") 指 定 切 入 点 表达 式 ; 
如 @Aspect("pertarget(target(cn.javass.spring.chapter6. service.IPointcutService)) 门 将 对 每 个 


匹配 “target(cn.javass.spring.chapter6.service. IPointcutService)" 切 入 点 表达 式 的 目标 对 象 创 
建 一 个 切面 ， 注 意 "|PointcutService”" 不 可 能 是 引入 接口 。 


在 进行 切面 定义 时 必须 将 切面 scope 定 义 为 “prototype”， 如 “<bean class="......Aspect" 
scope="prototype"/>”， 否 则 不 能 为 每 个 匹配 的 连接 点 的 目标 对 象 或 AOP 代 理 对 象 创建 一 个 切 
而 5 


示例 请 参考 cn.javass.spring.chapter6. InstanceModelTest 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list0/2475.html]】 


AS _ > > S ~ 、\2 
【第 六 章 】 AOP 之 6.9 代理 机 制 一 一 跟 我 学 
spring3 
Spring AOP 通 过 代理 模式 实现 ， 目 前 支持 两 种 代理 : JDK 动 态 代理 、CGLIB 代 理 来 创建 AOP 
代理 ，Spring 建 议 优先 使 用 JDK 动 态 代理 。 


。 JDK 动 态 代 理 : 使 用 java.lang.reflect.Proxy 动 态 代理 实现 ， 即 提取 目标 对 象 的 接口 ， 然 后 
对 接口 创建 AOP 代 理 。 

。 CGLIB 代 理 : CGLIB 代 理 不 仅 能 进行 接口 代理 ， 也 能 进行 类 代理 ，CGLIB 代 理 需要 注意 
以 下 问题 : 


能 通知 final 方 法 ， 因 为 final 方 法 不 能 被 履 盖 (CGLIB 通 过 生成 子 类 来 创建 代理 ) 。 


不 
会 产生 两 次 构造 器 调用 ， 第 一 次 是 目标 类 的 构造 器 调用 ， 第 二 次 是 CGLIB 生 成 的 代理 类 的 构 
造 器 


造 器 调用 。 如 果 需 要 CGLIB 代 理 方法 ， 请 确保 两 次 构造 器 调用 不 影响 应 用 。 


Spring AOP 默 认 首 先 使 用 JDK 动 态 代理 来 代理 目标 对 象 ， 如 果 目 标 对 象 没 有 实现 任何 接口 将 
使 用 CGLIB 代 理 ， 如 果 需 要 强制 使 用 CGLIB 代 理 ， 请 使 用 如 下 方式 指定 : 


对 于 Schema 风格 配置 切面 使 用 如 下 方式 来 指定 使 用 CGLIB 代 理 : 


<aop:config proxy-target-class="true"> 
</aop:config> 


而 如 果 使 用 @AspectJ 风 格 使 用 如 下 方式 来 指定 使 用 CGLIB 代 理 : 


<aop:aspectj-autoproxy proxy-target-class="true"/> 


【第 七 章 】 对 JDBC 的 支持 之 7.1 概述 一 一 跟 我 学 
spring3 


7.1 概述 


7.1.1 JDBC 回 顾 
传统 应 用 程序 开发 中 ， 进 行 JDBC 编 程 是 相当 痛苦 的 ， 如 下 所 示 : 


//cn.javass.spring.chapter7\. TraditionalJdbcTest 
@Test 
public void test() throws Exception { 
Connection conn = null; 
PreparedStatement pstmt = null; 
try { 
conn = getConnection(); //1. 获 取 JDBC 连 接 
//2. 声 明 SQL 
String sql = "select * from INFORMATION_SCHEMA.SYSTEM_ TABLES"; 
pstmt = conn.prepareStatement(sql1); //3. 预 编译 SQL 
ResultSet rs = pstmt.executeQuery(); //4. 执 行 SQL 





process(rs); //5. 处 理 结果 集 
closeResultSet (rs); //5. 释 放 结 果 集 
closeStatement(pstmt ) ; //6 .释放 Statement 
conn.commit(); //8. 提 交 事 务 


} catch (Exception e) { 

//9 .处 理 异 常 并 回 滚 事务 

conn.rollback( ); 

throw e; 

finally { 

//10 .释放 JDBC 连 接 ， 防 止 ]DBC 连 接 不 关闭 造成 的 内 存 泄漏 
closeConnection(conn); 


En] 


以 上 代码 片段 具有 宛 长 、 重 复 、 容 易 忘 记 某 一 步骤 从 而 导致 出 错 、 显 示 控 制 事务 、 显 示 处 理 
受 检 查 异 常 等 等 。 

有 朋友 可 能 重 构 出 自己 的 一 套 JDBC 模 板 ， 从 而 能 简化 日 常 开发 ， 但 自己 开发 的 JDBC 模 板 不 
够 通用 ， 而 且 对 于 每 一 套 JDBC 模 板 实现 都 差不多 ， 从 而 导致 开发 人 员 必 须 掌握 每 一 套 模 板 。 


Spring JDBC 提 供 了 一 套 JDBC 抽 象 框 架 ， 用 于 简化 JDBC 开 发 ， 而 且 如 果 各 个 公司 都 使 用 该 
抽象 框架 ， 开 发 人 员 首先 减少 了 学 习 成 本 ， 直 接 上 手 开 发 ， 如 图 7-1 所 示 。 


传统 JDBC Sprind JDBC 


a WD 苇 取 也 BC 车 找 
声明 SQL 2 声明 SQL 〔v ) 
3 . 预 编 译 SQL - 预 编译 SQ 
执行 SQL 执行 SC 
处 理 结 果 集 Gy 


处 理 异常 并 回 液 事 务 
0 .释放 JDBC 连 接 


1 简单 简 活 
| 2.Spring 事 务 管理 
3 每 个 步骤 不 可 获取 3. 只 做 需要 做 的 
显示 处 理 受 检查 异常 .一 致 的 非 检 查 异 常 体系 





图 7-1 Spring JDBC 与 传统 JDBC 编 程 对 比 


7.1.2 Spring 对 JDBC 的 支持 


Spring 通 过 抽象 JDBC 访 问 并 提供 一 致 的 AP| 来 简化 JDBC 编 程 的 工作 量 。 我 们 只 需要 声明 


SQL 、 调 用 合适 的 Spring JDBC 框 架 API、 处 理 结果 集 即 可 。 事 务 由 Spring 管理 ， 并 将 JDBC 


受 查 异常 转换 为 Spring 一 致 的 非 受 查 异 常 ， 从 而 简化 开发 。 
Spring 主要 提供 JDBC 模 板 方式 、 关 系数 据 库 对 象 化 方式 和 SimpleJdbc 方 式 三 种 方式 来 简化 
JDBC 编 程 ， 这 三 种 方式 就 是 Spring JDBC 的 工作 模式 : 
。 JDBC 模 板 方 式 : Spring JDBC 框 架 提 供 以 下 几 种 模板 类 来 简化 JDBC 编 程 ， 实 现 GoF 模 
板 设计 模式 ， 将 可 变 部 分 和 非 可 变 部 分 分 离 ， 可 变 部 分 采用 回调 接口 方式 由 用 户 来 实 

现 : 如 JdbcTemplate、NamedParameterJdbcTemplate、SimpleJdbcTemplate。 


。 关系 数据 库 操作 对 象 化 方式 : Spring JDBC 框 架 提 供 了 将 关系 数据 库 操作 对 象 化 的 表示 形 


式 ， 从 而 使 用 户 可 以 采用 面向 对 象 编程 来 完成 对 数据 库 的 访问 ; 如 MappingSqlQuery、 


SqlUpdate、SqlCall、SqlFunction、StoredProcedure 等 类 。 这 些 类 的 实现 一 旦 建立 即 可 


重用 并 且 是 线程 安全 的 。 
。 SimpleJdbc 方 式 : Spring JDBC 框 架 还 提供 了 SimpleJdbc 方 式 来 简化 JDBC 编 程 ， 
SimpleJdbclnsert 、SimpleJdbcCall 用 来 简化 数据 库 表 插 入 、 存 储 过 程 或 函数 访问 。 


JDBC 还 提供 了 一 些 强大 的 工具 类 ， 如 DataSourceUtils 来 在 必要 的 时 候 手 工 获取 数据 
连接 等 。 


7.1.4 Spring 的 JDBC 架 构 


Spring JDBC 抽 象 框架 由 四 部 分 组 成 : datasource、support、core、object。 如 图 7-2 所 示 。 


Spring JDBC 模块 


core object 


datasource support 





图 7-2 Spring JDBC 架 构图 
support 包 : 提供 将 JDBC 弄 常 转换 为 DAO 非 检查 出 常 转换 类 、 一 些 工具 类 如 JdbcUtils 等 。 


datasource 包 : 提供 简化 访问 JDBC 数据 源 (javax.sql.DataSource 实 现 ) 工具 类 ， 并 提供 了 


一 些 DataSource 简 单 实现 类 从 而 能 使 从 这 些 DataSource 获 取 的 连接 能 自动 得 到 Spring 管理 事 
务 支 持 。 

core 包 : 提供 JDBC 模 板 类 实现 及 可 变 部 分 的 回调 接口 ， 还 提供 SimpleJdbclnsert 等 简单 辅助 
类 。 


object 包 : 提供 关系 数据 库 的 对 象 表示 形式 ， 如 MappingSqlQuery、SqlUpdate、SqlCall、 
SqlFunction 、StoredProcedure 等 类 ， 该 包 是 基于 core 包 JDBC 模 板 类 实现 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2489.html] 
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7.2 JDBC 模 板 类 


7.2.1 概述 


Spring JDBC 抽 象 框 架 core 包 提供 了 JDBC 模 板 类 ， 其 中 JdbcTemplate 是 core 包 的 核心 类 ， 所 
以 其 他 模板 类 都 是 基于 它 封 装 完 成 的 ，JDBC 模 板 类 是 第 一 种 工作 模式 。 


JdbcTemplate 类 通过 模板 设计 模式 帮助 我 们 消除 了 兄长 的 代码 ， 只 做 需要 做 的 事情 ( 即 可 变 
部 分 ) ， 并 且 帮 我 们 做 哪些 固定 部 分 ， 如 连接 的 创建 及 关闭 。 


JdbcTemplate 类 对 可 变 部 分 采用 回调 接口 方式 实现 ， 如 ConnectionCallback 通 过 回调 接口 返 
回 给 用 户 一 个 连接 ， 从 而 可 以 使 用 该 连接 做 任何 事情 、StatementCallback 通 过 回调 接口 返回 
给 用 户 一 个 Statement， 从 而 可 以 使 用 该 Statement 做 任何 事情 等 等 ， 还 有 其 他 一 些 回 调 接口 
如 图 7-3 所 示 。 


预 编译 语句 设 值 相关 目下 六 功能 相关 


StatementCallback 


PreparedSstatementCallback 





图 7-3 JdbcTemplate 支 持 的 回调 接口 


Spring 除 了 提供 JdbcTemplate 核 心 类 ， 还 提供 了 基于 JdbcTemplate 实 现 的 
NamedParameterJdbcTemplate 类 用 于 支持 命名 参数 绑 定 、 SimpleJdbcTemplate 类 用 于 支持 
Java5+ 的 可 变 参 数 及 自动 装 箱 拆 箱 等 特性 。 


7.2.3 传统 JDBC 编 程 蔡 代 方案 


前 边 我 们 已 经 使 用 过 传统 JDBC 编 程 方式 ， 接 下 来 让 我 们 看 下 Spring JDBC 框 架 提供 的 更 好 的 
解决 方案 。 


1) 准备 需要 的 jar 包 并 添加 到 类 路 径 中 : 


//JDBC 抽 象 框架 模块 

org.springframework.jdbc-3.0.5.RELEASE.jar 

//Spring 事 务 管理 及 一 致 的 DAO 访 问 及 非 检查 异常 模块 
org.springframework.transaction-3.0.5.RELEASE.jar 

//hsqldb 了 驱动 ，hsqldb 是 一 个 开源 的 Java 实 现 数 据 库 ， 请 下 载 hsqldb2.0.0+ 版 本 
hsqldb.jar 


2) 传统 JDBC 编 程 蔡 代 方案 : 


在 使 用 JdbcTemplate 模 板 类 时 必须 通过 DataSource 获 取 数 据 库 连接 ，Spring JDBC 提 供 了 
看 过 


通 
DriverManagerDataSource 实 现 ， 它 通过 包装 “DriverManagergetConnection” 获 取 数 据 库 连 
接 ， 具 体 DataSource 相 关 请 参考 【7.5.1 控 制 数据 库 连 接 】。 


package cn.javass.spring.chapter7; 
import java,Ssql.ReSsultSet 
import java.sql.SsSQLException; 
import org.junit.AfterClass,; 
import org.junit.BeforeClass; 
import org.junit.Test; 
import org.springframework.jdbc.core.JdbcTemplate; 
import org.springframework.jdbc.core.RowCallbackHandler; 
import org.springframework.jdbc.datasource.DriverManagerDataSource; 
public class JdbcTemplateTest { 
private static JdbcTemplate jdbcTemplate,; 
@BeforeClass 
public static void setUpClass() { 
String url = "jdbc:hsqldb:mem:test"; 
String username = "sa"; 
String password = ""; 
DriverManagerDataSource dataSource = new DriverManagerDataSource(url, username, p 
dataSource.setDriverClassName("org.hsqldb.jdbcDriver"); 
jdbcTemplate = new JdbcTemplate(dataSource); 
} 
@Test 
public void test() { 
X71 声明 SQL 
String Sql = "select * from INFORMATION_SCHEMA.SYSTEM_ TABLES",; 
jdbcTemplate.query(sql, new RowCallbackHandler() { 
@Override 
public void processRow(ResultSet rs) throws SQLException { 
//2. 处 理 结果 集 
String value = rs.getSstring("TABLE_ NAME"); 
System.out.println("Column TABLENAME:" + value); 





接 下 来 让 我 们 具体 分 析 一 下 : 


1) jdbc:hsqldb:mem:test : 表示 使 用 hsqldb 内 存 数 据 库 ， 数 据 库 名 为 "test" 。 


2) public static void setUpClass() : 使 用 junit 的 @BeforeClass 注 解 ， 表 示 在 所 以 测试 方法 
之 前 执行 ， 且 只 执行 一 次 。 在 此 方法 中 定义 了 DataSource 并 使 用 DataSource 对 象 创建 了 
JdbcTemplate 对 象 。JdbcTemplate 对 象 是 线程 安全 的 。 


3) JdbcTemplate 执 行 流程 : 首先 定义 SQL ， 其 次 调用 JdbcTemplate 方 法 执行 SQL， 最 后 通 
过 RowCallbackHandler 回 调处 理 ResultSet 结 果 集 。 


Spring JDBC 解 决 方法 相 比 传统 JDBC 编 程 方式 是 不 是 简单 多 了 ， 有 是 不 是 只 有 可 变 部 分 需要 我 
们 来 做 ， 其 他 的 都 由 Spring JDBC 框 架 来 实现 了 。 


接 下 来 让 我 们 深入 JdbcTemplate 及 其 扩展 吧 。 


7.2.4 JdbcTemplate 
首先 让 我 们 来 看 下 如 何 使 用 JdbcTemplate 来 实现 增删 改 查 。 


一 、 首 先 创 建 表 结构 : 


// 代 码 片 段 (cn.javass.spring.chapter7.JdbcTemplateTest) 

@Before 

public void setUp() { 
String createTableSql = "create memory table test" + "(id int GENERATED BY DEFAULT AS 
jdbcTemplate.update(createTableSq]); 


@After 
public void tearDown() { 


String dropTabJleSql = "drop table test",; 
jdbcTemplate.execute(dropTableSsql1); 
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1) org.junit 包 下 的 @Before 和 @After 分 别 表 示 在 测试 方法 之 前 和 之 后 执行 的 方法 ， 对 于 每 个 
测试 方法 都 将 执行 一 次 ; 





2) create memory table test 表 示 创 建 hsqldb 内 存 表 ， 和 包含 两 个 字段 id 和 name， 其 中 id 是 具 
有 自 增 功 能 的 主键 ， 如 果 有 朋友 对 此 不 熟悉 hsqldb 可 以 换 成 熟悉 的 数据 库 。 


二 、 定 义 测试 骨架 ， 该 测试 方法 将 用 于 实现 增删 改 查 测试 : 


@Test 
public void testCURD() { 
insert(); 
delete( ); 
update( ); 
select( ); 
} 


三 、 新 增 测试 : 


private void insert() { 
jdbcTemplate.update("insert into test(name) values('name1')"); 
jdbcTemplate.update("insert into test(name) values('name2')"); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 


} 


四 、 删 除 测试 : 


private void delete() { 
jdbcTemplate.update("delete from test where name=?", new Object[]{"name2"}); 
Assert.assertEquals(1, jdbcTemplate.queryForIint("select count(*) from test")); 


} 


五 、 更 新 测试 : 


private void update() { 
jdbcTemplate.update("update test set name='name3' where name=?", new Object[]{"name1"}) 
Assert.assertEquals(1, jdbcTemplate.queryForIint("select count(*) from test where name=" 


} 
4| | 








六 、 查 询 测 试 : 


private void select() { 
jdbcTemplate.query("select * from test", new RowCallbackHandler(){ 
Q@Override 
public void processRow(ResultSet rs) throws SQLException { 
System.out.print("====id:" + rs.getIint("id")); 
System.out.printlin(",name:" + rs.getstring("name")); 


}); 
上 


看 完 以 上 示例 ， 大 家 是 否 觉 得 JdbcTemplate 简 化 了 我 们 很 多 劳动 力 呢 ? 接 下 来 让 我 们 深入 学 
习 一 下 JdbcTemplate 提 供 的 方法 。 
JdbcTemplate 主 要 提供 以 下 五 类 方法 : 


。 execute 方 法 : 可 以 用 于 执行 任何 SQL 语句 ， 一 般 用 于 执行 DDL 语 名 ; 

。 update 方 法 及 batchUpdate 方 法 : update 方 法 用 于 执行 新 增 、 修 改 、 删 除 等 语句 ; 
batchUpdate 方 法 用 于 执行 批 处 理 相 关 语 名 ; 

。 query 方 法 及 queryForXXX 方 法 : 用 于 执行 查询 相关 语句 ; 

。 call 方 法 : 用 于 执行 存储 过 程 、 函 数 相 关 语 钉 。 


JdbcTemplate 类 支持 的 回调 类 : 
。 预 编译 语句 及 存储 过 程 创 建 回调 : 用 于 根据 JdbcTemplate 提 供 的 连接 创建 相应 的 语句 ; 


PreparedStatementCreator : 通过 回调 获取 JdbcTemplate 提 供 的 Connection， 由 用 户 使 用 该 
Conncetion 创 建 相 关 的 PreparedStatement ; 


CallableStatementCreator : 通过 回调 获取 JdbcTemplate 提 供 的 Connection， 由 用 户 使 用 该 
Conncetion 创 建 相 关 的 CallableStatement ; 


。 预 编 译 语句 设 值 回调 : 用 于 给 预 编译 语句 相应 参数 设 值 ; 


PreparedStatementSetter : 通过 回调 获取 JdbcTemplate 提 供 的 PreparedStatement， 由 用 户 
来 对 相应 的 预 编译 语句 相应 参数 设 值 


BatchPreparedStatementSetter : ; 类 似 于 PreparedStatementSetter， 但 用 于 批 处 理 ， 需 
要 指定 批 处 理 大 小 ; 


e@ 自 定义 功能 回调 : 提供 给 用 户 一 个 扩展 点 ， 用 户 可 以 在 指定 类 型 的 扩展 点 执行 任何 数量 
需要 的 操作 ; 


ConnectionCallback : 通过 回调 获取 JdbcTemplate 提 供 的 Connection， 用 户 可 在 该 
Connection 执 行 任何 数量 的 操作 ; 


StatementCallback : 通过 回调 获取 JdbcTemplate 提 供 的 Statement， 用 户 可 以 在 该 
Statement 执 行 任何 数量 的 操作 ; 


PreparedStatementCallback : 通过 回调 获取 JdbcTemplate 提 供 的 PreparedStatement， 用 
户 可 以 在 该 PreparedStatement 执 行 任何 数量 的 操作 ; 


CallableStatementCallback : 通过 回调 获取 JdbcTemplate 提 供 的 CallableStatement， 用 户 
可 以 在 该 CallableStatement 执 行 任 何 数量 的 操作 ; 


e@ 结果 集 处 理 回 调 : 通过 回调 处 理 ResultSet 或 将 ResultSet 转 换 为 需要 的 形式 ; 


RowMapper : 用 于 将 结果 集 每 行 数据 转换 为 需要 的 类 型 ， 用 户 需 实现 方法 
mapRow(ResultSet rs, int rowNum) 来 完成 将 每 行 数 据 转换 为 相应 的 类 型 。 


RowCallbackHandler : 用 于 处 理 ResultSet 的 每 一 行 结 果 ， 用 户 需 实现 方法 
processRow(ResultSet rs) 来 完成 处 理 ， 在 该 回调 方法 中 无 需 执 行 rs.next()， 该 操作 由 
JdbcTemplate 来 执行 ， 用 户 只 需 按 行 获 取 数 据 然后 处 理 即 可 。 


ResultSetExtractor : 用 于 结果 集 数 据 提 取 ， 用 户 需 实现 方法 extractData(ResultSet rs) 来 处 
理 结果 集 ， 用 户 必 须 处 理 整个 结果 集 ; 


接 下 来 让 我 们 看 下 具体 示例 吧 ， 在 示例 中 不 可 能 介绍 到 JdbcTemplate 全 部 方法 及 回调 类 的 使 
用 方法 ， 我 们 只 介绍 代表 性 的 ， 其 余 的 使 用 都 是 类 似 的 ; 


1) 预 编 译 语句 及 存储 过 程 创建 回调 、 自 定义 功能 回调 使 用 : 


@Test 
public void testPpreparedStatement1() { 
int count = jdbcTemplate.execute(new PreparedStatementCreator() { 
Q@Override 
public PreparedStatement createPreparedStatement(Connection conn) 
throws SQLException { 
return conn.prepareStatement("select count(*) from test"); 
}}, new PreparedStatementCallback&lt;Integer&gt;() { 
Q@Override 
public Integer doInPreparedStatement(PreparedStatement pstmt) 
throws SQLException, DataAccessException { 
pstmt .execute( ); 
ResultSet rs = pstmt.getResultSet(); 
rs.next(); 
return rs.getIint(1); 
}}); 
Assert.assertEquals(0, count); 


} 


首先 使 用 PreparedStatementCreator 创 建 一 个 预 编译 语句 ， 其 次 由 JdbcTemplate 通 过 
PreparedStatementCallback 回 调 传 回 ， 由 用 户 决 定 如 何 执行 该 PreparedStatement。 此 处 我 


们 使 用 的 是 execute 方 法 。 


2) 预 编译 语句 设 值 回 调 使 用 : 


@Test 
public void testPreparedStatement2() { 
String insertSdql = "insert into test(name) values (?)"; 
int count = jdbcTemplate.update(insertSql, new PreparedStatementSetter() { 
@Override 
public void setValues(PreparedStatement pstmt) throws SQLException { 
pstmt.setOobject(1, "name4"); 
}}); 
Assert.assertEquals(1, count); 
String deleteSql = "delete from test where name=?"; 


count = jdbcTemplate.update(deleteSql, new Object[] {"name4"}); 
Assert.assertEquals(1, count); 


通过 JdbcTemplate 的 int update(String sql, PreparedStatementSetter pss) 执 行 预 编 译 sql， 其 
中 sql 参 数 为 “insert into test(name) values (?)”， 该 sq| 有 一 个 占 位 符 需要 在 执行 前 设 值 ， 
PreparedStatementSetter 实 现 就 是 为 了 设 值 ， 使 用 setValues(PreparedStatement pstmt) 回 调 
方法 设 值 相应 的 占 位 符 位 置 的 值 。JdbcTemplate 也 提供 一 种 更 简单 的 方式 “update(String sql， 
Object.. args)" 来 实现 设 值 ， 所 以 只 要 当 使 用 该 种 方式 不 满足 需求 时 才 应 使 用 


PreparedStatementSetter 。 


3) 结果 集 处 理 回 调 : 


@Test 
public void testResultSet1() { 
jdbcTemplate.update("insert into test(name) values('name5')"); 
String listSql = "select * from test"; 
List result = jdbcTemplate.query(listSql, new RowMapper&]t;Map&gt;() { 
@Override 
public Map mapRow(ResultSet rs, int rowNum) throws SQLException { 
Map row = new HashMap(); 
row.put(rs.getIint("id"), rs.getSstring("name")); 
return row; 
}}); 
Assert.assertEquals(1, result.size()); 
jdbcTemplate.update("delete from test where name='name5'"); 


RowMapper 接 口 提供 mapRow(ResultSet rs, int rowNum) 方 法 将 结果 集 的 每 一 行 转换 为 一 个 
Map， 当 然 可 以 转换 为 其 他 类 ， 如 表 的 对 象 画 形式 。 


QTest 
public void testResultSet2() { 
jdbcTemplate.update("insert into test(name) values('name5')"); 
String listSql = "select * from test"; 
final List result = new ArrayList(); 
jdbcTemplate.query(listSql, new RowCallbackHandler() { 
Q@Override 
public void processRow(ResultSet rs) throws SQLException { 
Map row = new HashMap(); 
row.put(rs.getIint("id"), rs.getSstring("name")); 
result.add(row); 
}}); 
Assert.assertEquals(1, result.size()); 
jdbcTemplate.update("delete from test where name='name5'"); 


RowCallbackHandler 接 口 也 提供 方法 processRow(ResultSet rs)， 能 将 结果 集 的 行 转换 为 需要 
的 形式 。 


@Test 
public void testResultSet3() { 
jdbcTemplate.update("insert into test(name) values('name5')"); 
String listSql = "select * from test"; 
List result = jdbcTemplate.query(listSql, new ResultSetExtractor&lt;List&gt;() { 
@Override 
public List extractData(ResultSet rs) 
throws SQLException, DataAccessException { 
List result = new ArrayList(); 
while(rs.next()) { 
Map row = new HashMap(); 
row.put(rs.getIint("id"), rs.getSstring("name")); 
result.add(row); 
} 
return result; 
}}); 
Assert.assertEquals(0, result.size()); 
jdbcTemplate.update("delete from test where name='name5'"); 


} 


ResultSetExtractor 使 用 回调 方法 extractData(ResultSet rs) 提 供给 用 户 整个 结果 集 ， 让 用 户 决 
定 如 何 处 理 该 结果 集 。 


当然 JdbcTemplate 提 供 更 简单 的 queryForXXX 方 法 ， 来 简化 开发 : 


//1. 查 询 一 行 数据 并 返回 jnt 型 结果 

jdbcTemplate.queryForIint("select count(*) from test"); 

//2\， 查 询 一 行 数据 并 将 该 行 数据 转换 为 Map 返 回 

jdbcTemplate.queryForMap("select * from test where name='nameS'"); 

//3. 查 询 一 行 任何 类 型 的 数据 ， 最 后 一 个 参数 指定 返回 结果 类 型 
jdbcTemplate.queryForObject("select count(*) from test", Integer.class); 
//4. 查 询 一 批 数据 ， 默 认 将 每 行 数据 转换 为 Map 

jdbcTemplate.queryForList("select * from test"); 

//5. 只 查询 一 列 数 据 列 表 ， 列 类 型 是 String 类 型 ， 列 名 字 是 name 
jdbcTemplate.queryForList(" 

select name from test where name=?", new Object[]{"name5S"}, String.class); 
//6 .查询 一 批 数据 ， 返 回 为 SqLRowSet， 类 似 于 ResulLtSet， 但 不 再 绑 定 到 连接 上 
SqlRowSet rs = jdbcTemplate.queryForRowSet("select * from test"); 


3) 存储 过 程 及 函数 回调 : 


首先 修改 JdbcTemplateTest 的 setUp 方 法 ， 修 改 后 如 下 所 示 : 


@Before 
public void setUp() { 
String createTableSql = "create memory table test" + 
"(id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, " + 
"name varchar(100))"; 
jdbcTemplate.update(createTableSq]l]); 


String createHsqldbFunctionSql] = 
"CREATE FUNCTION FUNCTION_TEST(Str CHAR(100)) " + 
"returns INT begin atomic return length(str);end"; 
jdbcTemplate.update(createHsqldbFunctionSq1); 
String createHsqldbProcedureSql = 
"CREATE PROCEDURE PROCEDURE_TEST" + 
"(INOUT inOutName VARCHAR(100), OUT outId INT) " + 
"MODIFIES SQL DATA " + 
"BEGIN ATOMIC " + 
" insert into test(name) values (inOutName); " + 
" SET outId = IDENTITY(); " + 
" SET inOutName = 'Hello,' + inOutName; ”十 
"END"; 
jdbcTemplate.execute(createHsqldbProcedureSsql1); 


其 中 CREATE FUNCTION FUNCTION_TEST 用 于 创建 自 定义 函数 ，CREATE PROCEDURE 
PROCEDURE_TEST 用 于 创建 存储 过 程 ， 注 意 这 些 创 建 语句 是 数据 库 相 关 的 ， 本 示例 中 的 语 
名 只 适用 于 HSQLDB 数 据 库 。 


其 次 修改 JdbcTemplateTest 的 tearDown 方 法 ， 修 改 后 如 下 所 示 : 


@After 

public void tearDown() { 
jdbcTemplate.execute("DROP FUNCTION FUNCTION_ TEST"); 
jdbcTemplate.execute("DROP PROCEDURE PROCEDURE_TEST"); 
String dropTableSql = "drop table test"; 
jdbcTemplate.execute(dropTableSsq1); 


其 中 drop 语 句 用 于 删除 创建 的 存储 过 程 、 自 定义 函数 及 数据 库 表 。 


接 下 来 看 一 下 hsqldb 如 何 调用 自 定义 函数 : 


@Test 
public void testCcallablestatementCreator1() { 
final String callFunctionSql = "{call FUNCTION_TEST(?)}"; 
List&]lt;SqlParameter&gt; params = new ArrayList&]t;SqlParameter&gt;(); 
params.add(new SqlParameter(Types .VARCHAR)); 
params.add(new SqlReturnResultSet("result", 
new ResultSetExtractor&lt;Integer&gt;() { 
@Override 
public Integer extractData(ResultSet rs) throws SQLException, 
DataAccessException { 
while(rs.next()) { 
return rs.getIint(1); 


return 0; 


})); 
Map&lt;String, Object&gt; outValues = jdbcTemplate.call( 
new CallableSstatementCreator() { 
@Override 
public CallableSstatement createCcallableSstatement(Connection conn) throws SQLE 
CallableSstatement cstmt = conn.prepareCcall(callFunctionSsql); 
cstmt.setstring(1, "test"); 
return cstmt,; 


}}, params); 
Assert.assertEquals(4, outValues.get("result")); 


村主 汪汪 于 | 


。 {call FUNCTION_TEST(?)} : 定义 自 定 义 函 数 的 Sql 语句， 注意 hsqldb {?= call ...} 和 {call 
...} 含 义 是 一 样 的 ， 而 比如 mysql 中 两 种 含义 是 不 一 样 的 ; 

。 params : 用 于 描述 自 定义 函数 占 位 符 参 数 或 命名 参数 类 型 ; SqlParameter 用 于 描述 IN 类 
型 参数 、SqlOutParameter 用 于 描述 OUT 类 型 参数 、SqlInOutParameter 用 于 描述 INOUT 
类 型 参数 、SqlReturnResultSet 用 于 描述 调用 存储 过 程 或 自 定义 函数 返回 的 ResultSet 类 
型 数据 ， 其 中 SqlReturnResultSet 需 要 提供 结果 集 处 理 回调 用 于 将 结果 集 转换 为 相应 的 形 
式 ，hsqldb 自 定义 函数 返回 值 是 ResultSet 类 型 。 

。 CallableStatementCreator : 提供 Connection 对 象 用 于 创建 CallableStatement 对 象 

。 outValues : 调用 call 方 法 将 返回 类 型 为 Map<String, Object> 对 象 ; 

。 outValues.get("result") : 获取 结果 ， 即 通过 SqlReturnResultSet 对 象 转换 过 的 数据 ; 其 
中 SqlOutParameter、SqlInOutParameter、SqlReturnResultSet 指 定 的 name 用 于 从 call 
执行 后 返回 的 Map 中 获取 相应 的 结果 ， 即 name 是 Map 的 键 。 





注 : 因为 hsqldb {?= call ...} 和 {call ...} 含 义 是 一 样 的 ， 因 此 调用 自 定 义 函 数 将 返回 一 个 包含 结 
果 的 ResultSet。 


最 后 让 我 们 示例 下 mysql 如 何 调用 自 定义 函数 : 


@Test 
public void testCallableStatementCreator2() { 
JdbcTemplate mysqlJdbcTemplate = new JdbcTemplate(getMysqlDataSource); 
//2. 创 建 自 定义 函数 
String createFunctionSql = 
"CREATE FUNCTION FUNCTION_TEST(Str VARCHAR(100)) ”+ 
"returns INT return LENGTH(str)"; 
String dropFunctionSql = "DROP FUNCTION IF EXISTS FUNCTION_TEST"; 
mysqlJdbcTemplate.update(dropFunctionSd]1) ; 
mysqlJdbcTemplate.update(createFunctionSsql); 
//3. 准 备 sql,mysql 支 持 {?= call ..} 
final String callFunctionSsql = "{?= call FUNCTION_TEST(?)}"; 
//4. 定 义 参 数 
List&]lt;SqlParameter&gt; params = new ArrayList&]lt;SqlParameter&gt;(); 
params.add(new SqlOutParameter("result", Types.INTEGER)); 
params.add(new SqlParameter("str", Types.VARCHAR)); 
Map&lt;String, Object&gt; outValues = mysqlJdbcTemplate.call( 
new CallablestatementCreator() { 
Q@override 
public CallableStatement createCallablestatement(Connection conn) throws SQLException 
Callablestatement cstmt = conn.prepareCall(callFunctionSql1); 
cstmt.registerOutParameter(1, Types.INTEGER); 
cstmt.setstring(2, "test"); 
return cstmt,; 
}}, params); 
Assert.assertEquals(4, outValues.get("result")); 


public DataSource getMysqlDataSource() { 
String Url = "jdbc:mysql://localhost:3306/test"; 
DriverManagerDataSource dataSource = 
new DriverManagerDataSource(url, "root", ""); dataSource.setDriverClassName(" 
return dataSource; 


} 
-| 


。 getMysqlDataSource : 首先 启动 mysql (本 书 使 用 5.4.3 版 本 ) ， 其 次 登录 mysql 创 建 test 
数据 库 (“create database test;”) ， 在 进行 测试 前 ， 请 先 下 载 并 添加 mysql-connector- 
java-5.1.10.jar 到 classpath ; 

。{?= call FUNCTION_TEST(?)} : 可 以 使 用 {3= call ...} 形 式 调用 自 定义 函数 ; 

。 params : 无 需 使 用 SqlReturnResultSet 提 取 结 果 集 数据 ， 而 是 使 用 SqlOutParameter 来 
描述 自 定义 函数 返回 值 ; 

。 CallableStatementCreator : 同上 个 例子 含义 一 样 ; 

。 cstmt.registerOutParameter(1, Types.INTEGER) : 将 OUT 类 型 参数 注册 为 JDBC 类 型 
Types.INTEGER， 此 处 即 返 回 值 类 VTVPeS NTE CER ° 

。 outValues.get("result") : 获取 结果 ， 直 接 返 回 Integer 类 型 ， 比 hsqldb 简 单 多 了 吧 。 





最 后 看 一 下 如 何如 何 调用 存储 过 程 


@Test 
public void testCallableStatementCreator3() { 
final String callProcedureSql = "{call PROCEDURE_TEST(?, ?)}"; 
List&]lt;SqlParameter&gt; params = new ArrayList&]t;SqlParameter&gt;(); 
params.add(new SqlInOutParameter("inOutName", Types.VARCHAR)); 
params.add(new SqlOutParameter("outId", Types.INTEGER)); 
Map&lt;String, Object&gt; outValues = jdbcTemplate.call( 
new CallableSstatementCreator() { 
@Override 
public CallableStatement createCallableStatement(Connection conn) throws SQLExcep 
CallableStatement cstmt = conn.prepareCall(callpProcedureSsq1); 
cstmt.registerOutParameter(1, Types .VARCHAR); 
cstmt.registerOutParameter(2, Types.INTEGER); 
cstmt.setstring(1, "test"); 
return cstmt,; 
}}, params); 
Assert.assertEquals("Hello, test", outValues.get("inOutName")); 
Assert.assertEquals(0, outValues.get("outId")); 





。 {call PROCEDURE_TEST(?, ?)} : 定义 存储 过 程 sql ; 

。 params : 定义 存储 过 程 参 数 ; SqllnOutParameter 描 述 INOUT 类 型 参数 、 
SqlOutParameter 描 述 OUT 类 型 参数 ; 

。 CallableStatementCreator : 用 于 创建 CallableStatement， 并 设 值 及 注册 OUT 参 数 类 型 ; 

。 outValues : 通过 SqlInOutParameter 及 SqlOutParameter 参 数 定义 的 name 来 获取 存储 过 
程 结果 。 


JdbcTemplate 类 还 提供 了 很 多 便利 方法 ， 在 此 就 不 一 一 介绍 了 ， 但 这 些 方 法 是 由 规律 可 循 
的 ， 第 一 种 就 是 提供 回调 接口 让 用 户 决定 做 什么 ， 第 二 种 可 以 认为 是 便利 方法 (如 
queryForXXX) ， 用 于 那些 比较 简单 的 操作 。 


7.2.4 NamedParameterJdbcTemplate 


NamedParameterJdbcTemplate 类 是 基于 JdbcTemplate 类 ， 并 对 它 进 行 了 封装 从 而 支持 命名 
参数 特性 。 


NamedParameterJdbcTemplate 主 要 提供 以 下 三 类 方法 : execute 方 法 、query 及 
queryForXXX 方 法 、update 及 batchUpdate 方 法 。 


首先 让 我 们 看 个 例子 吧 : 


@Test 

public void testNamedParameterJdbcTemplate1() { 
NamedParameterJdbcTemplate namedParameterJdbcTemplate = null; 
//namedParameterJdbcTemplate = 

// new NamedParameterJdbcTemplate(dataSource); 
namedParameterJdbcTemplate = 

new NamedParameterJdbcTemplate(jdbcTemplate); 


String insertSdql = "insert into test(name) values(:name)"; 
String selectSql = "select * from test where name=:name"; 
String deleteSdql = "delete from test where name=:name"; 


Map&lt;String, Object&gt; paramMap = new HashMap&]t;String, Objecte&gt;(); 
paramMap.put("name", "name5"); 
namedParameterJdbcTemplate.update(insertSql, paramMap); 
final List&lt;Integer&gt; result = new ArrayList&]lt;Integer&gt;(); 
namedParameterJdbcTemplate.query(selectSql, paramMap, 
new RowCallbackHandler() { 
@Override 
public void processRow(ResultSet rs) throws SQLException { 
result.add(rs.getIint("id")); 
} 
}); 


Assert.assertEquals(1, result.size()); 
SqlParameterSource paramSource = new MapSqlParameterSource(paramMap); 
namedParameterJdbcTemplate.update(deleteSql, paramSource); 


} 


接 下 来 让 我 们 分 析 一 下 代码 吧 : 


1) NamedParameterJdbcTemplate 初 始 化 : 可 以 使 用 DataSource 或 JdbcTemplate 对 象 作 
为 构造 器 参数 初始 化 ; 


2) insert into test(name) values(:name) : 其 中 “iname” 就 是 命名 参数 ; 


3) update(insertSql, paramMap) : 其 中 paramMap 是 一 个 Map 类 型 ， 包 含 键 为 “mame”， 值 
为 "mhame5” 的 键 值 对 ， 也 就 是 为 命名 参数 设 值 的 数据 ; 


4) query(selectSql, paramMap, new RowCallbackHandler()...... ) : 类 似 于 JdbcTemplate 
中 介绍 的 ， 唯 一 不 同 是 需要 传 入 paramMap 来 为 命名 参数 设 值 ; 


5) update(deleteSql, paramSource) : 类 似 于 “update(insertSql, paramMap)”， 但 使 用 
SqlParameterSource 参 数 来 为 命名 参数 设 值 ， 此 处 使 用 MapSqlParameterSource 实 现 ， 其 就 
是 简单 封装 java.util.Map。 


NamedParameterJdbcTemplate 类 为 命名 参数 设 值 有 两 种 方式 : java.util.Map 和 
SqlParameterSource : 


1) java.util.Map : 使 用 Map 键 数据 来 对 于 命名 参数 ， 而 Map 值 数据 用 于 设 值 ; 


2) SqlParameterSource : 可 以 使 用 SqlParameterSource 实 现 作为 来 实现 为 命名 参数 设 值 ， 
默认 有 MapSqlParameterSource 和 BeanPropertySqlParameterSource 实 现 ; 
MapSqlParameterSource 实 现 非常 简单 ， 只 是 封装 了 java.util.Map ; 而 
BeanPropertySqlParameterSource 封 装 了 一 个 JavaBean 对 象 ， 通 过 JavaBean 对 象 属性 来 决 
定 命 名 参数 的 值 。 


package cn.javass.spring.chapter7; 
public class USserModel { 

private int id; 

private String myName; 

// 省 略 getter 和 Setter 


@Test 

public void testNamedParameterJdbcTemplate2() { 
NamedParameterJdbcTemplate namedParameterJdbcTemplate = null; 
namedParameterJdbcTemplate = new NamedParameterJdbcTemplate(jdbcTemplate); 
UserModel model = new UserModel(); 
model.setMyName( "name5"); 
String insertSdql = "insert into test(name) values(:myName)"; 
SqlParameterSource paramSource = new BeanpPropertySqlParameterSource(model); 
namedParameterJdbcTemplate.update(insertSql, paramSource); 


可 以 看 出 BeanPropertySqlParameterSource 使 用 能 减少 很 多 工作 量 ， 但 命名 参数 必须 和 
JavaBean 属 性 名 称 相 对 应 才 可 以 。 


7.2.5 SimpleJdbcTemplate 


SimpleJdbcTemplate 类 也 是 基于 JdbcTemplate 类 ， 但 利用 Java5+ 的 可 变 参 数列 表 和 自动 装 箱 
和 拆 箱 从 而 获取 更 简洁 的 代码 。 


SimpleJdbcTemplate 主 要 提供 两 类 方法 : query 及 queryForXXX 方 法 、update 及 batchUpdate 
方法 。 


首先 让 我 们 看 个 例子 吧 : 


// 定 义 UserMode1 的 RowMapper 
package cn.javass.spring.chapter7; 
Import java,Ssql.ResultSet 
import java.sql.SsSQLException; 
import org.springframework.jdbc.core.RowMapper; 
public class UserRowMapper implements RowMapper&lt;UserModel&gt; { 
@Override 
public UserModel mapRow(ResultSet rs, int rowNum) throws SQLException { 
UserModel model = new UserModel(); 
model.setId(rs.getIint("id")); 
model.setMyName(rs.getstring("name")); 
return model; 


@Test 
public void testSimpleJdbcTemplate() { 
// 还 支持 DataSource 和 NamedParameterJdbcTemplate 作 为 构造 器 参数 
SimpleJdbcTemplate simpleJdbcTemplate = new SimpleJdbcTemplate(jdbcTemplate); 


String insertSql = "insert into test(id, name) values(?, ?)"; 
simpleJdbcTemplate.update(insertSql, 10, "nameS"); 
String selectSql] = "select * from test where id=? and name=?"; 


List&]lt;Map&lt;String, Object&gt;&gt; result = simpleJdbcTemplate.queryForList(select 
Assert.assertEquals(1, result.size()); 

RowMapper&lt;UserModel&gt; mapper = new UserRowMapper(); 

List&lt;UserModel&gt; result2 = simpleJdbcTemplate.query(selectSql, mapper, 10, "name 
Assert.assertEquals(1, result2.size()); 








1) SimpleJdbcTemplate 初 始 化 : 可 以 使 用 DataSource、JdbcTemplate 或 
NamedParameterJdbcTemplate 对 象 作为 构造 器 参数 初始 化 ; 


2) update(insertSql, 10, "name5") : 采用 Java5+ 可 变 参 数列 表 从 而 代替 new Object[]{10， 
"name5" 方式 ; 


3) query(selectSql, mapper 10, "name5") : 使 用 Java5+ 可 变 参 数列 表 及 RowMapper 回 调 
并 利用 泛 型 特性 来 指定 返回 值 类 型 (List<UserModel>) 。 


SimpleJdbcTemplate 类 还 支持 命名 参数 特性 ， 如 queryForList(String sql， 
SqlParameterSource args) 和 queryForList(String sql, Map<String, ?> args) ， 类 似 于 
NamedParameterJdbcTemplate 中 使 用 ， 在 此 就 不 介绍 了 。 


>|>> 注 :SimpleJdbcTemplate 还 提供 类 似 于 ParameterizedRowMapper 用 于 泛 型 特性 的 支 
持 ，ParameterizedRowMapper 是 RowMapper 的 子 类 ， 但 从 Spring 3.0 由 于 允许 环境 需要 
Java5+， 因 此 不 再 需要 ParameterizedRowMapper ， 而 可 以 直接 使 用 RowMapper ; > > 
query(String sql ParameterizedRowMapper<T> rm, SqlParameterSource args) > > 
query(String sql, RowMapper<T> rm, Object... args) // 直 接 使 用 该 语句 > > | 


> | > > SimpleJdbcTemplate 还 提供 如 下 方法 用 于 获取 JdbcTemplate 和 
NamedParameterJdbcTemplate : > > 1) 获取 JdbcTemplate 对 象 方法 : JdbcOperations 是 
JdbcTemplate 的 接口 > > JdbcOperations getJdbcOperations() > > 2) 获取 
NamedParameterJdbcTemplate 对 象 方 法 : NamedParameterJdbcOperations 是 
NamedParameterJdbcTemplate 的 接口 > > NamedParameterJdbcOperations 
getNamedParameterJdbcOperations()>> | 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2490.html] 


【第 七 章 】 对 JDBC 的 支持 之 7.3 关系 数据 库 操作 
对 象 化 一 一 跟 我 学 spring3 


7.3.1 概述 


所 谓 关 系数 据 库 对 象 化 其 实 就 是 用 面向 对 象 方 式 表示 关系 数据 库 操作 ， 从 而 可 以 复 用 。 


Spring JDBC 框 架 将 数据 库 操作 封装 为 一 个 RdbmsOperation， 该 对 象 是 线程 安全 的 、 可 复 用 
的 对 象 ， 是 所 有 数据 库 对 象 的 父 类 。 而 SqlOperation 继 承 了 RdbmsOperation， 代 表 了 数据 库 
SQL 操作 ， 如 select、update、call 等 ， 如 图 7-4 所 示 。 


关系 数据 库 操作 对 象 化 支持 类 











个 存储 过 程 及 函数 
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图 7-4 关系 数据 库 操作 对 象 化 支持 类 


数据 库 操 作对 象 化 只 要 有 以 下 几 种 类 型 ， 所 以 类 型 是 线程 安全 及 可 复 用 的 : 


。 查询 : 将 数据 库 操作 select 封 装 为 对 象 ， 查 询 操 作 的 基 类 是 SqlQuery， 所 有 查询 都 可 以 使 
用 该 类 表示 ，Spring JDBC 还 提供 了 一 些 更 容易 使 用 的 
MappingSqlQueryWithParameters 和 MappingSqlQuery 用 于 将 结果 集 映 射 为 Java 对 象 ， 
查询 对 象 类 还 提供 了 两 个 扩展 UpdatableSqlQuery 和 SqlFunction ; 

。 更 新 : 即 增删 改 操作 ， 将 数据 库 操作 insert 、update、delete 封 装 为 对 象 ， 增 删改 基 类 是 

SqlUpdate， 妆 然 还 提供 了 BatchSqlUpdate 用 于 批 处 理 ; 

存储 过 程 及 函数 : 将 存储 过 程 及 函数 调用 封装 为 对 象 ， 基 类 是 SqlCall 类 ， 提 供 了 

StoredProcedure 实 现 。 


7.3.2 查询 


1) SqlQuery : 需要 履 盖 如 下 方法 来 定义 一 个 RowMapper， 其 中 parameters 参 数 表示 命名 参 
数 或 点 位 符 参 数值 列表 ， 而 context 是 由 用 户 传 入 的 上 下 文 数 据 。 


RowMapper<T> newRowMapper (Object[] parameters, Map context) 


SqlQuery 提 供 两 类 方法 : 


。 execute 及 executeByNamedParam 方 法 : 用 于 查询 多 行 数据 ， 其 中 
executeByNamedParam 用 于 支持 命名 参数 绑 定 参数 ; 

。 findObject 及 findObjectByNamedParam 方 法 : 用 于 查询 单行 数据 ， 其 中 
findObjectByNamedParam 用 于 支持 命名 参数 绑 定 。 


演示 一 下 SqlQuery 如 何 使 用 : 


@Test 

public void testSqlQuery() { 
SqlQuery query = new UserModelSqlQuery(jdbcTemplate); 
List<UserModel> result = query.execute("name5"); 
Assert.assertEquals(0, result.size()); 


从 测试 代码 可 以 SqlQuery 使 用 非常 简单 ， 创 建 SqlQuery 实 现 对 象 ， 然 后 调用 相应 的 方法 即 
可 ， 接 下 来 看 一 下 SqlQuery 实 现 : 


package cn.javass.spring.chapter7; 

// 省 略 import 

public class UserModelSqlQuery extends SqlQuery<UserModel> { 

public UserModelsqlQuery(JdbcTemplate jdbcTemplate) { 

//super.setDataSsource(jdbcTemplate.getDataSource()); 
super.setJdbcTemplate(jdbcTemplate); 
super.setSql("select * from test where name=?") 
super ,declareParameter(new SqlParameter (Types .VARCHAR)); 
compile( ); 


@Override 

protected RowMapper<UserModel> newRowMapper (Object[] parameters, Map context) { 
return new UserRowMapper(); 

} 


从 测试 代码 可 以 看 出 ， 具 体 步 又 如 下 : 
一 、setJdbcTemplate/ setDataSource : 首先 设置 数据 源 或 JdbcTemplate ; 


二 、setSql("select * from test where name=?") : 定义 sql 语句， 所 以 定义 的 sql 语句 都 将 被 编 
译 为 PreparedStatement ; 

三 、declareParameter(new SqlParameter(Types.VARCHAR)) : 对 PreparedStatement 参 数 描 
述 ， 使 用 SqlParameter 来 描述 参数 类 型 ， 支 持 命名 参数 、 占 位 符 描述 ; 


对 于 命名 参数 可 以 使 用 如 new SqlParameter("name", Types.VARCHAR) 描 述 ; 注意 占 位 符 参 
数 描述 必须 按 占 位 符 参 数列 表 的 顺序 进行 描述 ; 


四 、 编 译 : 可 选 ， 当 执行 相应 查询 方法 时 会 自动 编译 ， 用 于 将 sql 编 译 为 
PreparedStatement， 对 于 编译 的 SqlQuery 不 能 再 对 参数 进行 描述 了 。 


五 、 以 上 步骤 是 不 可 变 的 ， 必 须 按 顺序 执行 。 


2) MappingSqlQuery : 用 于 简化 SqlQuery 中 RowMapper 创 建 ， 可 以 直接 在 实现 
mapRow(ResultSet rs, int rowNum) 来 将 行 数据 映射 为 需要 的 形式 ; 


MappingSqlQuery 所 有 查询 方法 完全 继承 于 SqlQuery。 


演示 一 下 MappingSqlQuery 如 何 使 用 : 


QTest 

public void testMappingSqlQuery() { 
jdbcTemplate.update("insert into test(name) values('name5')"); 
SqlQuery<UserModel> query = new UserModelMappingSqlQuery(jdbcTemplate); 
Map<String, Object> paramMap = new HashMap<String, Object>(); 
paramMap.put("name", "name5"); 
UserModel result = query.findobjectByNamedParam(paramMap); 
Assert.assertNotNull(result); 


MappingSqlQuery 使 用 和 SqlQuery 完 全 一 样 ， 创 建 MappingSqlQuery 实 现 对 象 ， 然 后 调用 相 
应 的 方法 即 可 ， 接 下 来 看 一 下 MappingSqlQuery 实 现 ，findObjectByNamedParam 方 法 用 于 执 
行 命名 参数 查询 : 


package cn.javass.spring.chapter7; 

// 省 略 import 

public class UserModelMappingSqlQuery extends MappingSqlQuery<UserModel> { 

public UserModelMappingSqlQuery(JdbcTemplate jdbcTemplate) { 

super.setDataSource(jdbcTemplate.getDataSource( )); 
super.setSql("select * from test where name=:name"); 
super.declareParameter (new SqlParameter("name", Types .VARCHAR)); 
compile( ); 


@Override 
protected UserModel mapRow(ResultSet rs, int rowNum) throws SQLException { 
UserModel model = new UserModel(); 
model.setId(rs.getIint("id")); 
model.setMyName(rs.getstring("name")); 
return model; 


和 SqlQuery 唯 一 不 同 的 是 使 用 mapRow 来 讲 每 行 数 据 转换 为 需要 的 形式 ， 其 他 地 方 完 全 一 
样 。 


1) UpdatableSqlQuery : 提供 可 更 新 结果 集 查 询 支 持 ， 子 类 实现 UpdateRow(ResultSet rs， 
int rowNum, Map context) 对 结果 集 进行 更 新 。 


2) GenericSqlQuery : 提供 setRowMapperClass(Class rowMapperClass) 方 法 用 于 指定 
RowMapper 实 现 ， 在 此 就 不 演示 了 。 具 体 请 参考 testGenericSqlQuery() 方 法 。 


3) SqlFunction : SQL 函数 "包装 器 ， 用 于 支持 那些 返回 单行 结果 集 的 查询 。 该 类 主要 用 于 
返回 单行 单列 结果 集 。 


@Test 

public void testSqlFunction() { 
jdbcTemplate.update("insert into test(name) values('name5')"); 
String countSql = "select count(*) from test",; 
SqlFunction<Integer> sqlFunction1 = new SqlFunction<Integer>(jdbcTemplate.getDataSour 
Assert.assertEquals(1, sqlFunctioni.run()); 
String selectSql = "select name from test where name=?"; 
SqlFunction<String> sqlFunction2 = new SqlFunction<String>(jdbcTemplate.getDataSource 
sqlFunction2.declareParameter(new SqlParameter (Types .VARCHAR)); 
String name = (String) sqlFunction2.runGeneric(new Object[] {"nameS"}); 
Assert.assertEquals("name5", name); 


} 
EEC 
如 代码 所 示 ，SqlFunction 初 始 化 时 需要 DataSource 和 相应 的 sql 语句 ， 如 果 有 参数 需要 使 用 


declareParameter 对 参数 类 型 进行 描述 ; run 方 法 默认 返回 int 型 ， 当 然 也 可 以 使 用 runGeneric 
返回 其 他 类 型 ， 如 String 等 。 





7.3.3 更 新 


SqlUpdate 类 用 于 支持 数据 库 更 新 操作 ， 即 增删 改 (insert、delete、update) 操作 ， 该 方法 类 
似 于 SqlQuery， 只 是 职责 不 一 样 。 


SqlUpdate 提 供 了 update 及 updateByNamedParam 方 法 用 于 数据 库 更 新 操作 ， 其 中 
updateByNamedParam 用 于 命名 参数 类 型 更 新 。 


演示 一 下 SqlUpdate 如 何 使 用 : 


package cn.javass.spring.chapter7; 

// 省 略 import 

public class InsertUserModel extends SqlUpdate { 

public InsertUserModel(JdbcTemplate jdbcTemplate) { 

super.setJdbcTemplate(jdbcTemplate); 
Super ,SetSql("insert into test(name) values(?)"); 
super.declareParameter(new SqlParameter (Types .VARCHAR)); 
compile( ); 


@Test 

public void testSqlUpdate() { 
SqlUpdate insert = new InsertUserModel(jdbcTemplate); 
insert .update("name5") 


String UpdateSql = "update test set name=? where name=?",; 

SqlUpdate update = new SqlUpdate(jdbcTemplate.getDataSource(), updateSsql, new int[]{T 
update.update("name6", "name5"); 

String deleteSql = "delete from test where name=:name",; 


SqlUpdate delete = new SqlUpdate(jdbcTemplate.getDataSource(), deleteSql, new int[]{T 
Map<String, Object> paramMap = new HashMap<String, Object>(); 

paramMap.put("name", "name5"); 

delete.updateByNamedParam(paramMap); 


4 一 








InsertUserModel 类 实现 类 似 于 SqlQuery 实 现 ， 用 于 执行 数据 库 插 入 操作 ，SqlUpdate 还 提供 
一 种 更 简洁 的 构造 器 SqlUpdate(DataSource ds, String sql, int[] types)， 其 中 types 用 占 
位 符 或 命名 参数 类 型 ; SqlUpdate 还 支持 命名 参数 ， 使 用 updateByNamedParam 方 法 来 进 

命名 参数 操作 。 


7.3.4 存储 过 程 及 有 函数 


StoredProcedure 用 于 支持 存储 过 程 及 函数 ， 该 类 的 使 用 同样 类 似 于 SqlQuery。 
StoredProcedure 提 供 execute 方 法 用 于 执行 存储 过 程 及 函数 。 


一 、StoredProcedure 如 何 调用 自 定 义 函 数 : 


@Test 

public void testStoredProcedure1() { 
StoredProcedure lengthFunction = new HsqldbLengthFunction(jdbcTemplate); 
Map<String,Object> outValues = lengthFunction.execute("test"); 
Assert.assertEquals(4, outValues.get("result")); 


StoredProcedure 使 用 非常 简单 ， 定 义 StoredProcedure 实 现 HsqldbLengthFunction， 并 调用 
execute 方 法 执行 即 可 ， 接 下 来 看 一 下 HsqldbLengthFunction 实 现 : 


package cn.javass.spring.chapter7; 
// 省 略 import 
public class HsqldbLengthFunction extends StoredProcedure { 
public HsqldbLengthFunction(JdbcTemplate jdbcTemplate) { 
super.setJdbcTemplate(jdbcTemplate); 
super.setSql("FUNCTION_TEST"); 
super .declareParameter( 
new SqlReturnResultSet("result", new ResultSetExtractor<Integer>() { 
@Override 
public Integer extractData(ResultSet rs) throws SQLException, DataAccessExcep 
while(rs.next()) { 
return rs.getInt(1); 
} 


return 0; 


} 
})); 
super.declareParameter(new SqlParameter("str", Types.VARCHAR)); 
compile( ); 





StoredProcedure 自 定义 函数 使 用 类 似 于 SqlQuery， 首 先 设置 数据 源 或 JdbcTemplate 对 象 ， 其 
次 定义 自 定义 函数 ， 然 后 使 用 declareParameter 进 行 参数 描述 ， 最 后 调用 compile (可 选 ) 编 
译 自 定义 函数 。 


接 下 来 看 一 下 mysql 自 定义 函数 如 何 使 用 : 


@Test 
public void testStoredProcedure2() { 
JdbcTemplate mysqlJdbcTemplate = new JdbcTemplate(getMysqlDataSource()); 
String createFunctionSql] = 
"CREATE FUNCTION FUNCTION_TEST(Str VARCHAR(100)) "+ 
"returns INT return LENGTH(str)"; 
String dropFunctionSql = "DROP FUNCTION IF EXISTS FUNCTION_TEST"; 
mysqlJdbcTempJlate.update(dropFunctionSql) ; 
mysqlJdbcTempJlate.update(createFunctionSql) ; 
StoredProcedure lengthFunction = new MysqlLengthFunction(mysqlJdbcTemplate); 
Map<String,Object> outValues = lengthFunction.execute("test"); 
Assert.assertEquals(4, outValues.get("result")); 


MysqlLengthFunction 自 定义 函数 使 用 与 HsqldbLengthFunction 使 用 完全 一 样 ， 只 是 内 部 实现 
稍 有 差别 : 


package cn.javass.spring.chapter7; 

// 省 略 import 

public class MysqlLengthFunction extends StoredProcedure { 

public MysqlLengthFunction(JdbcTemplate jdbcTemplate) { 

super.setJdbcTemplate(jdbcTemplate); 
super.setSql("FUNCTION_TEST"); 
super.setFunction(true); 
super ,declareParameter(new SqlOutParameter("result", Types.INTEGER)); 
super.declareParameter(new SqlParameter("str", Types.VARCHAR)); 
compile( ); 


MysqlLengthFunction 与 HsqldbLengthFunction 实 现 不 同 的 地 方 有 两 点 : 


。 setFunction(true) : 表示 是 自 定义 函数 调用 ， 即 编译 后 的 sq 为 {?= call ...} 形 式 ; 如 果 使 
用 hsqldb 不 能 设置 为 true， 因 为 在 hsqldb 中 {?= call ...} 和 {call ...} 含 义 一 样 ; 

。 declareParameter(new SqlOutParameter("result", Types.INTEGER)) : 将 自 定 义 函 数 
返回 值 类 型 直接 描述 为 Types.INTEGER ; SqlOutParameter 必 须 指定 name ， 而 不 用 使 用 
SqlReturnResultSet 首 先 获取 结果 集 ， 然 后 再 从 结果 集 获取 返回 值 ， 这 是 mysq|l 与 hsqldb 
的 区 别 ; 


一 、StoredProcedure 如 何 调用 存储 过 程 : 


@Test 

public void testStoredProcedure3() { 
StoredProcedure procedure = new HsqldbTestProcedure(jdbcTemplate); 
Map<String,Object> outValues = procedure.execute("test"); 
Assert.assertEquals(©0, outValues.get("outId")); 
Assert.assertEquals("Hello, test", outValues.get("inOutName")); 


StoredProcedure 存 储 过 程 实现 HsqldbTestProcedure 调 用 与 HsqldbLengthFunction 调 用 完全 
一 样 ， 不 同 的 是 在 实现 时 ， 参 数 描 述 稍 有 不 同 : 


package cn.javass.spring.chapter7; 

// 省 略 import 

public class HsqldbTestProcedure extends StoredProcedure { 

public HsqldbTestProcedure(JdbcTemplate jdbcTemplate) { 

super.setJdbcTemplate(jdbcTemplate); 
super.setSql("PROCEDURE_TEST"); 
super.declareParameter(new SqlInOutParameter("inOutName", Types.VARCHAR)); 
super.declareParameter(new SqlOutParameter("outId", Types.INTEGER)); 
compile( ); 


e。 declareParameter : 使 用 SqllInOutParameter 描 述 INOUT 类 型 参数 ， 使 用 
SqlOutParameter 描 述 OUT 类 型 参数 ， 必 须 按 顺序 定义 ， 不 能 颠倒 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2491.html] 


【第 七 章 】 对 JDBC 的 支持 之 7.4 Spring 提供 的 其 
它 帮助 一 一 跟 我 学 spring3【 私 部 在 线 原创 】 


7.4 Spring 提 供 的 其 它 帮 助 


7.4.1 SimpleJdbc 方 式 


Spring JDBC 抽 象 框架 提供 SimpleJdbclnsert 和 SimpleJdbcCall 类 ， 这 两 个 类 通过 利用 JDBC 
驱动 提供 的 数据 库 元 数据 来 简化 JDBC 操 作 。 


1、SimpleJdbclnsert : 用 于 插入 数据 ， 根 据 数据 库 元 数据 进行 插入 数据 ， 本 类 用 于 简化 插入 
操作 ， 提 供 三 种 类 型 方法 : execute 方 法 用 于 普通 插入 、executeAndReturnKey 及 
executeAndReturnKeyHolder 方 法 用 于 插入 时 获取 主键 值 、executeBatch 方 法 用 于 批 处 理 。 


@Test 

public void testSimpleJdbcInsert() { 
SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate); 
insert.withTableName("test"); 
Map<String, Object> args = new HashMap<String, Object>(); 
args.put("name", "name5s"); 
insert.compile( ); 
//1. 普 通 插 入 
insert.execute(args); 
Assert.assertEquals(1, jdbcTemplate.queryForIint("select count(*) from test")); 
//2 .插入 时 获取 主键 值 
insert = new SimpleJdbcInsert(jdbcTemplate); 
insert.withTableName("test"); 
insert.setGeneratedKeyName("id"); 
Number id = insert.executeAndReturnKey(args); 
Assert.assertEquals(1, id); 
//3. 批 处 理 
insert = new SimpleJdbcInsert(jdbcTemplate); 
insert.withTableName("test"); 
insert.setGeneratedKeyName("id"); 
int[] updateCount = insert.executeBatch(new Map[] {args, args, args}); 
Assert.assertEquals(1, updateCount[0]); 
Assert.assertEquals(5, jdbcTemplate.queryForIint("select count(*) from test")); 


。new SimpleJdbclnsert(jdbcTemplate) : 首次 通过 DataSource 对 象 或 JdbcTemplate 对 
象 初始 化 SimpleJdbclnsert ; 

。 insert.withTableName("test") : 用 于 设置 数据 库 表 名 ; 

。 args : 用 于 指定 插入 时 列 名 及 值 ， 如 本 例 中 只 有 name 列 名 ， 即 编译 后 的 sql 类 似 
村 "insert into test(name) values(?); 

。 insert.compile() : 可 选 的 编译 步骤 ， 在 调用 执行 方法 时 自动 编译 ， 编 译 后 不 能 再 对 
insert 对 象 修 改 ; 

。 执行 : execute 方 法 用 于 执行 普通 插入 ; executeAndReturnKey 用 于 执行 并 获取 自动 生成 
主键 (注意 是 Number 类 型 ) ， 必 须 首先 通过 setGeneratedKeyName 设 置 主键 然后 才能 
获取 ， 如 果 想 获取 复合 主键 请 使 用 setGeneratedKeyNames 描 述 主键 然后 通过 


executeReturningKeyHolder 获 取 复 合 主键 KeyHolder 对 象 ; executeBatch 用 于 批 处 理 ; 


2、SimpleJdbcCall : 用 于 调用 存储 过 程 及 自 定义 函数 ， 本 类 用 于 简化 存储 过 程 及 自 定义 函数 
调用 。 


@Test 

public void testSimpleJdbcCall1() { 
// 此 处 用 mysql, 因为 hsqldb 调 用 自 定义 函数 和 存储 过 程 一 样 
SimpleJdbcCall call = new SimpleJdbcCall(getMysqlDataSource()); 
call.withFunctionName("FUNCTION_TEST"); 
call.declareParameters(new SqlOutParameter("result", Types.INTEGER)); 
call.declareParameters(new SqlParameter("str", Types.VARCHAR)); 
Map<String, Object> outVlaues = call.execute("test"); 
Assert.assertEquals(4, outVlaues.get("result")); 


。 new SimpleJdbcCall(getMysqlDataSource()) : 通过 DataSource 对 象 或 JdbcTemplate 
对 象 初始 化 SimpleJdbcCall ; 

。 withFunctionName("FUNCTION_TEST") : 定义 自 定义 函数 名 ; 自 定义 函数 Sql 语句 将 
被 编译 为 类 似 于 {?= call ...} 形 式 ; 

。 declareParameters : 描述 参数 类 型 ， 使 用 方式 与 StoredProcedure 对 象 一 样 ; 

。 执行 : 调用 execute 方 法 执行 自 定 义 函 数 ; 


QTest 
public void testSimpleJdbcCall2() { 
// 调 用 hsqldb 自 定义 函数 得 使 用 如 下 方式 
SimpleJdbcCall call = new SimpleJdbcCcall(jdbcTemplate); 
call.withProcedureName("FUNCTION_TEST"); 
call.declareParameters(new SqlReturnResultSet("result", 
new ResultSetExtractor<Integer>() { 
@Override 
public Integer extractData(ResultSet rs) 
throws SQLException, DataAccessException { 
while(rs.next()) { 
return rs.getIint(1); 
} 
return 0; 
}})); 
call.declareParameters(new SqlParameter("str", Types.VARCHAR)); 
Map<String, Object> outVlaues = call.execute("test"); 
Assert.assertEquals(4, outVlaues.get("result")); 


调用 hsqldb 数 据 库 自 定义 函数 与 调用 mysql 自 定义 函数 完全 不 同 ， 详 见 StoredProcedure 中 的 
解释 。 


QTest 

public void testSimpleJdbcCall3() { 
SimpleJdbcCall call = new SimpleJdbcCcall(jdbcTemplate); 
call.withPprocedureName("PROCEDURE_TEST"); 
call.declareParameters(new SqlInOutParameter("inOutName", Types .VARCHAR)); 
call.declareParameters(new SqlOutParameter("outId", Types.INTEGER)); 
SqlParameterSource params = 
new MapSqlParameterSource().addValue("inOutName", "test"); 
Map<String, Object> outVlaues = call.execute(params); 
Assert.assertEquals("Hello, test", outVlaues.get("inOutName")); 
Assert.assertEquals(0, outVlaues.get("outId")); 


与 自 定义 函数 调用 不 同 的 是 使 用 withProcedureName 来 指定 存储 过 程 名 字 ; 其 他 参数 描述 
完全 一 样 。 


7.4.2 控制 数据 库 连 接 
Spring JDBC 通 过 DataSource 控 制 数据 库 连接 ， 即 通过 DataSource 实 现 获 取 数 据 库 连接 。 
Spring JDBC 提 供 了 一 下 DataSource 实 现 : 


。 DriverManagerDataSource : 简单 封装 了 DriverManager 获 取 数 据 库 连接 ; 通过 
DriverManager 的 getConnection 方 法 获取 数据 库 连 接 ; 

。 SingleConnectionDataSource : 内 部 封装 了 一 个 连接 ， 该 连接 使 用 后 不 会 关闭 ， 且 不 
能 在 多 线程 环境 中 使 用 ， 一 般 用 于 测试 ; 

。LazyConnectionDataSourceProxy : 包装 一 个 DataSource， 用 于 延迟 获取 数据 库 连 
接 ， 只 有 在 申 正 创建 Statement 等 时 才 获 取 连 接 ， 因 此 再 说 实际 项 目 中 最 后 使 用 该 代理 包 
装 原始 DataSource 从 而 使 得 只 有 在 丨 正 需要 连接 时 才 去 获取 。 


第 三 方 提供 的 DataSource 实 现 主要 有 C3P0、Proxool、DBCP 等 ， 岗 都 具有 数据 库 连 
接 池 能 力 。 


DataSourceUtils : Spring JDBC 抽 象 框 架 内 部 都 是 通过 它 的 getConnection(DataSource 
dataSource) 方 法 获取 数据 库 连 接 ，releaseConnection(Connection con, DataSource 
dataSource) 用 于 释放 数据 库 连 接 ， Rd ， 只 有 使 用 
DataSourceUtils 获 取 的 连接 才 具 有 Spring 管理 事务 


7.4.3 获取 自动 生成 的 主键 


有 许多 数据 库 提供 自动 生成 主键 的 能 力 ， 因 此 我 们 可 能 需要 获取 这 些 自动 生成 的 主键 ，JDBC 
3.0 标 准 支 持 获 取 自 动 生成 的 主键 ， 且 必须 数据 库 支 持 自动 生成 键 获 取 。 


1 ) JdbcTemplate 获取 自动 生成 主键 方式 : 


@Test 
public void testFetchKey1() throws SQLException { 
final String insertSdql = "insert into test(name) values('name5')"; 
KeyHolder generatedKeyHolder = new GeneratedKeyHolder(); 
jdbcTemplate.update(new PreparedStatementCreator() { 
Q@Override 
public PreparedStatement createPreparedStatement(Connection conn) 
throws SQLException { 
return conn.prepareStatement(insertSql, new String[]{"ID"}); 
}}, generatedKeyHolder); 
Assert.assertEquals(0, generatedKeyHolder .getkey()); 


使 用 JdbcTemplate 的 update(final PreparedStatementCreator psc, final KeyHolder 
generatedKeyHolder) 方 法 执行 需要 返回 自动 生成 主键 的 插入 语句 ， 其 中 psc 用 于 创建 
PreparedStatement 并 指定 自动 生成 键 ， 如 “prepareStatement(insertSql, new String[] 
{"ID"))”; generatedKeyHolder 是 KeyHolder 类 型 ， 用 于 获取 自动 生成 的 主键 或 复合 主键 ; 如 使 
用 getKey 方 法 获取 自动 生成 的 主键 。 


2 ) SqlUpdate 获取 自动 生成 主键 方式 : 


@Test 

public void testFetchKey2() { 
final String insertSql = "insert into test(name) values('name5')"; 
KeyHolder generatedKeyHolder = new GeneratedKeyHolder(); 
SqlUpdate update = new SqlUpdate(); 
update.setJdbcTemplate(jdbcTemplate); 
update.setReturnGeneratedKeys(true); 
//update.setGeneratedKeysColumnNames(new String[]{"ID"}); 
update.setSql(insertSql); 
update.update(null, generatedKeyHolder ); 
Assert.assertEquals(0, generatedKeyHolder .getkey()); 


SqlUpdate 获 取 自 动 生成 主键 方式 和 JdbcTemplate 完 全 一 样 ， 可 以 使 用 
setReturnGeneratedKeys (true) 表示 要 获取 自动 生成 键 ; 也 可 以 使 用 
setGeneratedKeysColumnNames 指 定 自动 生成 键 列 名 。 


3 ) SimpleJdbclnsert : 前 边 示 例 已 介绍 ， 此 处 就 不 演示 了 。 


7.4.4 JDBC 批 量 操 作 


JDBC 批 处 理 用 于 减少 与 数据 库 交 互 的 次 数 来 提升 性 能 ，Spring JDBC 抽 象 框 架 通 过 封装 批 处 
理 操 作 来 简化 批 处 理 操作 


1 ) JdbcTemplate 批 处 理 : 支持 普通 的 批 处 理 及 占 位 符 批 处 理 ; 


@Test 
public void testBatchUpdate1() { 
String insertSdql = "insert into test(name) values('name5')"; 
String[] batchsql = new String[] {insertSql, insertSql}; 
jdbcTemplate.batchUpdate(batchsql); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 


直接 调用 batchUpdate 方 法 执行 需要 批 处 理 的 语 匈 即 可 。 


@Test 
public void testBatchUpdate2() { 
String insertSdql = "insert into test(name) values(?)"; 


final String[] batchValues = new String[] {"name5", "name6"}; 
jdbcTemplate.batchUpdate(insertSql, new BatchPreparedStatementSetter() { 
@Override 
public void setValues(PreparedStatement ps, int i) throws SQLException { 
ps.setstring(1, batchvalues[i]); 
} 


@Override 

public int getBatchSize() { 
return batchvalues.1length,; 

} 


}); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 


JdbcTemplate 还 可 以 通过 batchUpdate(String sql, final BatchPreparedStatementSetter pss) 
方法 进行 批 处 理 ， 该 方式 使 用 预 编译 语句 ， 然 后 通过 BatchPreparedStatementSetter 实 现 进行 
设 值 (setValues) 及 指定 批 处 理 大 小 (getBatchSize) 。 


2 ) NamedParameterJdbcTemplate 批 处 理 : 支持 命名 参数 批 处 理 ; 


@Test 
public void testBatchUpdate3() { 
NamedParameterJdbcTemplate namedParameterJdbcTemplate = new NamedParameterJdbcTemplat 
String insertSdql = "insert into test(name) values(:myName)"; 
UserModel model = new UserModel( ); 
model.setMyName( "name5" ); 
SqlParameterSource[] params = SqlParameterSourceUtils.createBatch(new Object[] {model 
namedParameterJdbcTemplate.batchUpdate(insertSql, params); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 
} 


Ee 





通过 batchUpdate(String sql, SqlIParameterSource[] batchArgs) 方 法 进行 命名 参数 批 处 理 ， 
batchArgs 指 定 批 处 理 数据 集 。SqlParameterSourceUtils.createBatch 用 于 根据 JavaBean 对 象 
或 者 Map 创 建 相 应 的 BeanPropertySqlParameterSource 或 MapSqlParameterSource。 


3) SimpleJdbcTemplate 批 处 理 : 已 更 简单 的 方式 进行 批 处 理 ; 


@Test 
public void testBatchUpdate4() { 
SimpleJdbcTemplate simpleJdbcTemplate = new SimpleJdbcTemplate(jdbcTemplate); 
String insertSdql = "insert into test(name) values(?)"; 
List<object[]> params = new ArrayList<0bject[]>(); 
params .add(new Object[]{"nameS"}); 
params.add(new Object[]{"nameS"}); 
simpleJdbcTemplate.batchUpdate(insertSql, params); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 


本 示例 使 用 batchUpdate(String sql, List<Object[]> batchArgs) 方 法 完成 占 位 符 批 处 理 ， 当 然 
也 支持 命名 参数 批 处 理 等 。 


4 ) SimpleJdbclnsert 批 处 理 : 


QTest 
public void testBatchUpdate5() { 
SimpleJdbcInsert insert = new SimpleJdbcInsert(jdbcTemplate); 
insert.withTableName("test"); 
Map<String, Object> valueMap = new HashMap<String, Object>(); 
valueMap.put("name", "name5"); 
insert.executeBatch(new Map[] {valueMap, valueMap}); 
Assert.assertEquals(2, jdbcTemplate.queryForIint("select count(*) from test")); 


} 


如 代码 所 示 ， 使 用 executeBatch(Map<String, Object>[] batch) 方 法 执行 批 处 理 。 


【第 七 章 】 对 JDBC 的 支持 之 7.5 集成 Spring 
JDBC 及 节 住 实践 一 一 跟 我 学 spring3 


7.5 集成 Spring JDBC 及 最 住 实践 


大 多 数 情况 下 Spring JDBC 都 是 与 IOC 容 器 一 起 使 用 。 通 过 配置 方式 使 用 Spring JDBC。 


而 且 大 部 分 时 间 都 是 使 用 JdbcTemplate 类 (或 SimpleJdbcTemplate 和 
NamedParameterJdbcTemplate) 进行 开发 ， 即 可 能 80% 时 间 使 用 JdbcTemplate 类 ， 而 只 有 
20% 时 间 使 用 其 他 类 开发 ， 符 合 80/20 法 则 。 


Spring JDBC 通 过 实现 DaoSupport 来 支持 一 致 的 数据 库 访问 。 
Spring JDBC 提 供 如 下 DaoSupport 实 现 : 


。 JdbcDaoSupport : 用 于 支持 一 致 的 JdbcTemplate 访 问 ; 

。 NamedParameterJdbcDaoSupport: 继 承 JdbcDaoSupport， 同 时 提供 
NamedParameterJdbcTemplate 访 问 ; 

。 SimpleJdbcDaoSupport : 继承 JdbcDaoSupport， 同 时 提供 SimpleJdbcTemplate 访 
问 。 


由 于 JdbcTemplate、NamedParameterJdbcTemplate、SimpleJdbcTemplate 类 使 用 
DataSourceUtils 获 取 及 释放 连接 ， 而 且 连 接 是 与 线程 绑 定 的 ， 因 此 这 些 JDBC 模 板 类 是 线程 安 
全 的 ， 即 JdbcTemplate 对 象 可 以 在 多 线程 中 重用 。 


接 下 来 看 一 下 Spring JDBC 框 架 的 最 佳 实践 : 


1) 首 先 定 义 Dao 接 口 


package cn.javass.spring.chapter7.dao; 
import cn.javass.spring.chapter7.UserModel; 
public interface IUserDao { 
public void save(UserModel model); 
public int countAll(); 
} 


2) 定义 Dao 实 现 ， 此 处 是 使 用 Spring JDBC 实 现 : 


package cn.javass.spring.chapter7.dao.jdbc; 

Import org.springframework,.jdbc,core,namedparam.BeanPropertySqlParameterSource 

Import org.springframework,.jdbc,core,Ssimple.SimpleJdbcDaoSupport ; 

Import cn.javass.spring.chapter7 .UserModel; 

import cn.javass.spring.chapter7.dao.IUserDao; 

public class UserJdbcDaoImpl extends SimpleJdbcDaoSupport implements IUserDao { 
private static final String INSERT_SQL = "insert into test(name) values(:myName)"; 
private static final String COUNT_ALL_ SQL = "select count(*) from test"; 


@Override 
public void save(UserModel model) { 
getSimpleJdbcTemplate().update(INSERT_ SQL, new BeanpPropertySqlParameterSource(model 


@Override 
public int countAll() { 
return getJdbcTemplate().queryForInt(COUNT_ALL_ SQL); 





此 处 注意 首先 Spring JDBC 实 现 放 在 dao.jdbc 包 里 ， 如 果 有 hibernate 实 现 就 放 在 dao.hibernate 
包 里 ; 其 次 实现 类 命名 如 UserJdbcDaolmpl， 即 xxxJdbcDaolmpl， 当 然 如 果 自己 有 更 好 的 合 
名 规范 可 以 遵循 自己 的 ， 此 处 只 是 提 个 建议 。 


3) 进行 资源 配置 (resources/chapter7/applicationContext-resources.xml) 


<bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
<property name="locations"> 
<list> 
<value>classpath:chapter7/resources.properties</value> 
</list> 
</property> 
</bean> 


PropertyPlaceholderConfigurer 用 于 替换 配置 元 数据 ， 如 本 示例 中 将 对 bean 定 义 中 的 ${...} 占 
位 符 资源 用 “classpath:chapter7/resources.properties” 中 相应 的 元 素 替 换 。 


<bean id="dataSource" class="org.springframework.jdbc.datasource.LazyConnectionDataSource 
<property name="targetDataSource"> 
<bean class="org.logicalcobwebs.proxool.ProxoolDataSource"> 
<property name="driver" value="${db.driver.class}" /> 
<property name="driverUrl" value="${db.url}" /> 
<property name="user" value="${db.username}" /> 
<property name="password" value="${db.password}" /> 
<property name="maximumConnectionCount" 
value="${proxool.maxConnCount}" /> 
<property name="minimumConnectionCount" 
value="${proxool.minConnCount}" /> 
<property name="statistics" value="${proxool.statistics}" /> 
<property name="simultaneousBuildThrottle" 
value="${proxool.simultaneousBuildThrottle}" /> 
<property name="trace" value="${proxool.trace}" /> 
</bean> 
</property> 
</bean> 
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dataSource 定 义 数据 源 ， 本 示例 使 用 proxool 数 据 库 连 接 池 ， 并 使 用 
LazyConnectionDataSourceProxy 包 装 它 ， 从 而 延迟 获取 数据 库 连 接 ; ${db.driver.class} 将 
被 “classpath:chapter7/resources.properties” 中 的 “db.driver.class” 元 素 属 性 值 替换 。 


proxool 数 据 库 连接 池 : 本 示例 使 用 proxool-0.9.1 版 本 ， 请 到 proxool 官 网 下 载 并 添加 proxool- 
0.9.1.jar 和 proxool-cglib.jar 到 类 路 径 。 


ProxoolDataSource 属 性 含义 如 下 : 


。 driver : 指定 数据 库 驱 动 ; 

e。 driverUrl : 数据 库 连 接 ; 

。 Username : 用 户 名 ; 

。 password : 密码 ; 

。 maximumConnectionCount : 连接 池 最 大 连接 数量 ; 

。 minimumConnectionCount : 连接 池 最 小 连接 数量 ; 

e statistics : 连接 池 使 用 样本 状况 统计 ; 如 1m,15m,1h,1d 表 示 没 1 分 钟 、15 分 钟 、1 小 时 及 
1 天 进行 一 次 样本 统计 ; 

。 SimultaneousBuildThrottle : 一 次 可 以 创建 连接 的 最 大 数量 ; 

。 trace : true 表 示 被 执行 的 每 个 sql 都 将 被 记录 (DEBUG 级 别 时 被 打印 到 相应 的 日 志 
件 ) ; 


4) 定义 资源 文件 (classpath:chapter7/resources.properties) 


proxool.maxConnCount=10 
proxool.minConnCount=5 
proxool.statistics=1im,15m,1h,1d 
proxool.simultaneousBuildThrottle=30 
proxool.trace=false 
db.driver.class=org.hsqldb.jdbcDriver 
db.url=jdbc:hsqldb:mem: test 
db.username=sa 

db .password= 


用 于 替换 配置 元 数据 中 相应 的 占 位 符 数 据 ， 如 ${db.driver.class} 将 被 替换 
为 “org.hsdldb.jdbcDriver 。 


5) dao 定 义 配 置 (chapter7/applicationContext-jdbc.xml ) 


<bean id="abstractDao" abstract="true"> 
<property name="dataSource" ref="dataSource"/> 

</bean> 

<bean id="userDao" 
class="cn.javass.spring.chapter7.dao.jdbc.UserJdbcDaoImpl" 
parent="abstractDao"/> 


首先 定义 抽象 的 abstractDao， 其 有 一 个 dataSource 属 性 ， 从 而 可 以 让 继承 的 子 类 自动 继承 
dataSource 属 性 注入 ; 然后 定义 UserDao， 且 继承 abstractDao， 从 而 继承 dataSource 注 入 ; 
我 们 在 此 给 配置 文件 命名 为 applicationContext-jdbc.xml 表 示 Spring JDBC DAO 实 现 ; 如 果 使 


用 hibernate 实 现 可 以 给 配置 文件 命名 为 applicationContext-hibernate.xml 。 
6) 最 后 测试 一 下 吧 (cn.javass.spring.chapter7. JdbcTemplateTest ) 


@Test 
public void testBestPractice() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter7/applicationContext-jdbc.xml"}; 

ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 

IUserDao userDao = ctx.getBean(IUserDao.class); 

UserModel model = new UserModel(); 

model.setMyName("test"); 

userDao.save(model); 

Assert.assertEquals(1, userDao.countAll()); 


首先 读 取 配置 文件 ， 获 取 IUserDao 接 口 实现 ， 然 后 再 调用 IUserDao 接 口 方法 ， 进 行 数据 库 操 
作 ， 这 样 对 于 开发 人 员 使 用 来 说 ， 只 面向 接口 ， 不 关心 实现 ， 因 此 很 容易 更 换 实 现 ， 比 如 像 
更 换 为 hibernate 实 现 非常 简单 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2493.html] 


【第 八 章 】 对 ORM 的 支持 之 8.1 概述 一 一 跟 我 学 
spring3 


8.1 概述 


8.1.1 ORM 框 架 


ORM 全 称 对 象 关系 映射 (Object/Relation Mapping) ， 指 将 Java 对 象 状态 自动 映射 到 关系 数 
据 库 中 的 数据 上 ， 从 而 提供 透明 化 的 持久 化 支持 ， 即 把 一 种 形式 转化 为 另 一 种 形式 。 


对 象 与 关系 数据 库 之 间 是 不 匹配 ， 我 们 把 这 种 不 匹配 称 为 阻抗 失 配 ， 主 要 表现 在 : 


e 关系 数据 库 首先 不 支持 面向 对 象 技术 如 继承 、 多 态 ， 如 何 使 关系 数据 库 支持 它们 ; 

e 关系 数据 库 是 由 表 来 存放 数据 ， 而 面向 对 象 使 用 对 象 来 存放 状态 ; 其 中 表 的 列 称 为 属 
性 ， 而 对 象 的 属性 就 是 属性 ， 因 此 需要 通过 解决 这 种 不 匹配 ; 

。 如 何 将 对 象 透 明 的 持久 化 到 关系 数据 库 表 中 

e 如 果 一 个 对 象 存在 横 跨 多 个 表 的 数据 ， 应 该 如 何 为 对 象 建 模 和 映射 。 


其 中 这 些 阻 抗 失 配 只 是 其 中 的 一 小 部 分 ， 比 如 还 有 如 何 将 SQL 集合 函数 结果 集 映射 到 对 象 ， 

如 何在 对 象 中 处 理 主 键 等 。 

ORM 框 架 就 是 用 来 解决 这 种 阻抗 失 配 ， 提 供 关 系数 据 库 的 对 象 化 支持 。 

ORM 框 架 不 是 万 能 的 ， 同 样 符合 801/20 法 则 ， 应 解决 的 最 核心 问题 是 如 何在 关系 数据 库 表 中 的 
行 和 对 银 进 行 映 射 ， 并 自动 持久 化 对 银 到 关系 数据 库 。 

ORM 解 决 方案 适用 于 解决 透明 持久 化 、 小 结果 集 查 询 等 ; 对 于 复杂 查询 ， 大 结果 集 数 据 处 理 
还 是 没有 任何 帮助 的 。 


目前 已 经 有 许多 ORM 框 架 产 生 ， 如 Hibernate、JDO、JPA、iBATIS 等 等 ， 这 些 ORM 框 架 各 有 
特色 ，Spring 对 这 些 ORM 框 架 提供 了 很 好 的 支持 ， 接 下 来 首先 让 我 们 看 一 下 Spring 如 何 支持 
这 些 ORM 框 架 。 


8.1.2 Spring 对 ORM 的 支持 


Spring 对 ORM 的 支持 主要 表现 在 以 下 方面 : 


e 一 致 的 异常 体系 结构 ， 对 第 三 方 ORM 框 架 抛 出 的 专 有 异常 进行 包装 ， 从 而 在 使 我 们 在 
Spring 中 只 看 到 DataAccessException 异 常 体系 ; 

e 一 致 的 DAO 抽 象 支持 : 提供 类 似 与 JdbcSupport 的 DAO 支 持 类 HibernateDaoSupport， 使 
用 HibernateTemplate 模 板 类 来 简化 常用 操作 ，HibernateTemplate 提 供 回 调 接口 来 支持 复 


杂 操 作 ; 
。 Spring 事务 管理 : Spring 对 所 有 数据 访问 提供 一 致 的 事务 管理 ， 通 过 配置 方式 ， 简 化 事务 
管理 。 


Spring 还 在 测试 、 数 据 源 管理 方面 提供 支持 ， 从 而 允许 方便 测试 ， 简 化 数据 源 使 用 。 
接 下 来 让 我 们 学 习 一 下 Spring 如 何 集成 ORM 框 架 一 Hibernate。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2495.html] 


【第 八 章 】 对 ORM 的 支持 之 8.2 集成 Hibernate3 
一 一 跟 我 学 spring3 


8.2 集成 Hibernate3 


Hibernate 有 是 全 自动 的 ORM 框 架 ， 能 自动 为 对 象 生 成 相应 SQL 并 透明 的 持久 化 对 象 到 数据 库 。 


Spring2.5+ 版 本 支持 Hibernate 3.1+ 版 本 ， 不 支持 低 版 本 ，Spring3.0.5 版 本 提供 对 
Hibernate 3.6.0 Final 版 本 支持 。 


8.2.1 如 何 集 成 
Spring 通过 使 用 如 下 Bean 进 行 集成 Hibernate : 
。 LocalSessionFactoryBean : 用 于 支持 XML 映射 定义 读 取 : 


configLocation 和 configLocations : 用 于 定义 Hibernate 配 置 文件 位 置 ， 一 般 使 用 如 
classpath:hibernate.cfg.xml 形 式 指定 ; 


mappingLocations : 用 于 指定 Hibenate 了 映射 文件 位 置 ， 如 chapter8/hbm/userhbm.xml ; 
hibernateProperties : 用 于 定义 Hibernate 属 性 ， 即 Hibernate 配 置 文件 中 的 属性 ; 
dataSource : 定义 数据 源 ; 


hibernateProperties、dataSource 用 于 消除 Hibernate 配 置 文件 ， 因 此 如 果 使 用 
configLocations 指 定 配 置 文件 ， 就 不 要 设置 这 两 个 属性 了 ， 否 则 会 产生 重复 配置 。 推 荐 使 用 
dataSource 来 指定 数据 源 ， 而 使 用 hibernateProperties 指 定 Hibernate 属 性 。 


。 AnnotationSessionFactoryBean : 用 于 支持 注解 风格 映射 定义 读 取 ， 该 类 继承 
LocalSessionFactoryBean 并 额外 提供 自动 查找 注解 风格 配置 模型 的 能 


annotatedClasses : 设置 注解 了 模型 类 ， 通 过 注解 指定 映射 元 数据 。 


packagesToScan : 通过 扫描 指定 的 包 获 取 注 解 模 型 类 ， 而 不 是 手工 指定 ， 
如 “cn.javass.**.model” 将 扫描 cn.javass 包 及 子 包 下 的 model 包 下 的 所 有 注解 模型 类 。 


接 下 来 学 习 一 下 Spring 如 何 集成 Hibernate 吧 : 
1、 准 备 jar 包 : 
首先 准备 Spring 对 ORM 框 架 支 持 的 jar 包 : 


。 org.springframework.orm-3.0.5.RELEASE.jar /提供 对 ORM 框 架 集 成 


下 载 hibernate-distribution-3.6.0.Final 包 ， 获 取 如 下 Hibernate 需 要 的 jar 包 : 


。 hibernate3.jar /核心 包 

。 lib\required\antlr-2.7.6.jar /WHQL 解析 时 使 用 的 包 

。 lib\required\javassist-3.9.0.GA.jar // 字 节 码 类 库 ， 类 似 于 cglib 

。 lib\required\commons-collections-3.1.jar // 对 集合 类 型 支持 包 ， 前 边 测试 时 已 经 提供 过 
了 ， 无 需 再 拷贝 该 包 了 

。 lib\required\dom4j-1.6.1.jar //xml 解 析 包 ， 用 于 解析 配置 使 用 

。 lib\required\jta-1.1.jar //JTA 事 务 支持 包 

。 libjpa\hibernate-jpa-2.0-api-1.0.0.Final.jar /用 于 支持 JPA 


下 载 slf4j-1.6.1.zip (http://www.slf4j.org/download.html) ，slf4j 是 日 志 系 统 门面 (Simple 
Logging Facade for Java) ， 用 于 对 各 种 日 志 框架 提供 给 一 致 的 日 志 访 问 接口 ， 从 而 能 随时 
替换 日 志 框架 (如 log4j、java.util.logging) 


。 slf4j-api-1.6.1.jar /核心 API 
。 slf4j-log4j12-1.6.1.jar /log4j 实 现 


将 这 些 jar 包 添加 到 类 路 径 中 。 


2 、 对 象 模型 定义 ， 此 处 使 用 第 七 章 中 的 UserModel : 


package cn.javass.spring.chapter7; 
public class UserModel] { 

private int id; 

private String myName; 

// 省 略 getter 和 setter 


3、Hibernate 喘 射 定义 (chapter8/hbm/user.hbm.xml) ， 定 义 对 象 和 数据 库 之 间 的 映射 : 


&lt;?xml1 version="1.0" encoding="UTF-8"?&gt; 
&lt; IDOCTYPE hibernate-mapping PUBLIC 
"-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"&gt; 
&lt;hibernate-mapping&gt; 
&lt;class name="cn.javass.spring.chapter7.UserModel" table="test"&gt; 
&lt;id name="id" column="id"&gt;&]lt;generator class="native"/&gt;&]lt;/id&gt; 
&lt;property name="myName" column="name"/&gt; 
&lt;/class&gt; 
&lt;/hibernate-mapping&gt; 


4、 数据 源 定义 ， 此 处 使 用 第 7 章 的 配置 文件 ， 即 “chapter7/applicationContext- 
resources.xml” 文 件 。 


5、SessionFactory 配 置 定义 (chapter8/applicationContext-hibernate.xml) 


&lt;bean id="sessionFactory" class="org.springframework.orm.hibernate3.LocalSessionFactor 


&lt;property name="dataSource" ref="dataSource"/&gt; &lt;!1-- 指定 数据 源 --&gt; 

&lt;property name="mappingResources"&gt; &1lt;1-- 指定 映射 定义 --&gt，; 

&lt;1list&gt; 
&lt;value&gt;chapter8/hbm/user.hbm.xml&lt;/value&gt; 

&lt;/list&gt; 

&lt;/property&gt; 

&lt;property name="hibernateProperties"&gt; &lt;!-- 指 定 Hibernate 铬 性 --&gt; 
&lt;props&gt; 


&lt;prop key="hibernate.dialect"&gt; 
org.hibernate.dialect.HSQLDialect 
&lt;/prop&gt; 
&lt;/props&gt; 
&lt;/property&gt; 
&1lt;/beanggt; 
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6、 获 取 SessionFactory : 


package cn.javass.spring.chapter8; 

// 省 略 import 

public class HibernateTest { 

private static SessionFactory sessionFactory; 
@BeforeClass 

public static void beforeClass() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-hibernate.xml"}; 

ApplicationContext ctx = new ClassPathXmlApplicationContext(configLocations); 

sessionFactory = ctx.getBean("sessionFactory", SessionFactory.class); 


cc 


此 处 我 们 使 用 了 chapter7/applicationContext-resources.xml 定 义 的 “dataSource” 数 据 源 ， 通 过 
ctx.getBean("sessionFactory" SessionFactory.class) 获 取 SessionFactory 。 


7、 通 过 SessionFactory 获 取 Session 对 象 进行 创建 和 删除 表 : 


@Before 

public void setUp() { 
//id 自 增 主 键 从 0 开始 
final String createTableSql = "create memory table test" + "(id int GENERATED BY DEFAUL 
sessionFactory.openSsession(). 


createsQLQuery(createTableSql).executeUpdate( ); 
} 
@After 


public void tearDown() { 
final String dropTableSql = "drop table test"; 
sessionFactory.openSsSession(). 


createSQLQuery(dropTableSql) .executeUpdate( ); 
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使 用 SessionFactory 创 建 Session， 然 后 通过 Session 对 象 的 createSQLQuery 创 建 本 地 SQL 执 
行 创建 和 删除 表 。 


8、 使 用 SessionFactory 获 取 Session 对 象 进行 持久 化 数据 : 


@Test 
public void testFirst() { 
Session session = sessionFactory.openSession(); 
Transaction transaction = null; 
try { 
transaction = beginTransaction(session); 
UserModel model = new UserModel(); 
model.setMyName( "myName"); 
session.save(model); 
} catch (RuntimeException e) { 
rollbackTransaction(transaction); 
throw e; 
} finally { 
commitTransaction(session); 
} 


private Transaction beginTransaction(Session session) { 
Transaction transaction = session.beginTransaction(); 
transaction.begin(); 
return transaction; 


} 
private void rollbackTransaction(Transaction transaction) { 
if(transaction != null) { 
transaction.rollback(); 
} 
} 


private void commitTransaction(Session session) { 
session.close(); 


使 用 SessionFactory 获 取 Session 进 行 操 作 ， 必 须 自 己 控制 事务 ， 而 且 还 要 保证 各 个 步骤 不 会 
出 错 ， 有 没有 更 好 的 解决 方案 把 我 们 从 编程 事务 中 解脱 出 来 ? Spring 提供 了 
HibernateTemplate 模 板 类 用 来 简化 事务 处 理 和 常见 操作 。 


8.2.2 使 用 HibernateTemplate 


HibernateTimplate 模 板 类 用 于 简化 事务 管理 及 常见 操作 ， 类 似 于 JdbcTemplate 模 板 类 ， 对 于 
复杂 操作 通过 提供 HibernateCallback 回 调 接口 来 允许 更 复杂 的 操作 。 


接 下 来 示例 一 下 HibernateTemplate 的 使 用 : 


@Test 
public void testHibernateTemplate() { 
HibernateTemplate hibernateTemplate = 
new HibernateTemplate(sessionFactory); 
final UserModel model = new UserModel(); 
model.setMyName( "myName"); 
hibernateTemplate.save(model); 
// 通 过 回调 允许 更 复杂 操作 
hibernateTemplate.execute(new HibernateCallback&]lt;Void&gt;() { 
@Override 
public Void doInHibernate(Session session) 
throws HibernateException, SQLException { 
session.save(model); 
return null; 


}}); 


通过 new HibernateTemplate(sessionFactory) 创建 HibernateTemplate 模 板 类 对 象 ， 通 过 调用 
模板 类 的 save 方 法 持久 化 对 象 ， 并 且 自 动 享受 到 Spring 管理 事务 的 好 处 。 


而 且 HibernateTemplate 提供 使 用 HibernateCallback 回 调 接口 的 方法 execute 用 来 支持 复杂 操 
作 ， 当 然 也 自动 享受 到 Spring 管理 事务 的 好 处 。 


8.2.3 集成 Hibernate 及 最 住 实践 


类 似 于 JdbcDaoSupport 类 ，Spring 对 Hibernate 也 提供 了 HibernateDaoSupport 类 来 支持 一 致 
的 数据 库 访 问 。HibernateDaoSupport 也 是 DaoSupport 实 现 : 


接 下 来 示例 一 下 Spring 集成 Hibernate 的 最 佳 实践 : 
1、 定义 Dao 接 口 ， 此 处 使 用 cn.javass.spring.chapter7.dao. IUserDao : 


2、 定义 Dao 接 口 实现 ， 此 处 是 Hibernate 实 现 : 


package cn.javass.spring.chapter8.dao.hibernate,; 

import org.springframework.orm.hibernate3.support.HibernateDaoSupport,; 

import cn.javass.spring.chapter7 .UserModel; 

import cn.javass.spring.chapter7.dao.IUserDao; 

public class UserHibernateDaoImpl extends HibernateDaoSupport implements IUserDao { 
private static final String COUNT_ALL_ HQL = "select count(*) from UserModel"; 
@Override 
public void save(UserModel model) { 

getHibernateTemplate().save(model); 


@Override 

public int countAll() { 
Number count = (Number) getHibernateTemplate().find(COUNT_ALL_HQL).get(0); 
return count.intValue(); 


此 处 注意 首先 Hibernate 实 现 放 在 dao.hibernate 包 里 ， 其 次 实现 类 命名 如 
UserHibernateDaolmpl， 即 xxxHibernateDaolmpl， 当 然 如 果 自 己 有 更 好 的 命名 规范 可 以 遵 
循 自己 的 ， 此 处 只 是 提 个 建议 。 


3、 行 资源 配置 ， 使 用 resources/chapter7/applicationContext-resources.xml : 


4、dao 定 义 配置 ， 在 chapter8/applicationContext-hibernate.xml 中 添加 如 下 配置 


&lt;bean id="abstractDao" abstract="true"&gt,; 
&lt;property name="sessionFactory" ref="sessionFactory"/&gt; 
&lt;/beanggt; 
&lt;bean id="userDao" class="cn.javass.spring.chapter8.dao.hibernate.UserHibernateDaoImp 


首先 定义 抽象 的 abstractDao， 其 有 一 个 sessionFactory 属 性 ， 从 而 可 以 让 继承 的 子 类 自动 继 


承 sessionFactory 属 性 注入 ; 然后 0 ， 且 继承 abstractDao， 从 而 继承 
sessionFactory 注 入 ; 我 们 在 此 给 配置 文件 命名 为 applicationContext-hibernate.xml 表 示 





Hibernate 实 现 。 


5、 最 后 测试 一 下 吧 (cn.javass.spring.chapter8. HibernateTest ) 


@Test 


public void testBestPractice() { 
String[] configLocations = new String[] { 


"classpath: 
"classpath: 
ApplicationContext 


chapter7/applicationContext-resources.xml", 
chapter8/applicationContext-hibernate.xml"}; 
ctx = new ClassPathxmlApplicationContext(configLocations); 


IUserDao userDao = ctx.getBean(IUserDao.class); 
UserModel model = new UserModel(); 
model.setMyName("test"); 


userDao.save(model); 


Assert.assertEquals(1, userDao.countAll()); 


和 Spring JDBC 框 架 的 最 佳 实践 完全 一 样 ， 除 了 使 用 applicationContext-hibernate.xml 代 替 了 
applicationContext-jdbc.xml， 其 他 完全 一 样 。 也 就 是 说 ，DAO 层 的 实现 替换 可 以 透明 化 。 


8.2.4 Spring+Hibernate 的 CRUD 


Spring+Hibernate CRUD (增删 改 查 ) 我 们 使 用 注解 类 来 示例 ， 让 我 们 看 具体 示例 吧 : 


1、 首 先 定义 带 注 解 的 模型 对 象 UserModel2 : 


。 使 用 JPA 注 解 @Table 指 定 表 名 映射 ; 
。 使 用 注解 @Id 指 定 主键 映射 ; 
。 使 用 注解 @ Column 指 定数 据 库 列 映射 ; 


package cn.javass.spring 


import 
import 
import 
import 
import 
import 


@Entity 


javax. 
javax. 
javax. 
javax. 
javax. 
javax. 


@Table(name = "test") 


public class UserModel2 { 


.Cchapter8; 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 
persistence. 


Column; 

Entity; 
GeneratedValue; 
GenerationType; 
Id; 

Table; 


@Id @GeneratedValue(strategy = GenerationType.AUTO) 
private int id; 


@Column(name = "name" 


private String myName; 
// 省 略 getter 和 Setter 


2、 定义 配置 文件 (chapter8/applicationContext-hibernate2.xm|l) 


2.1、 定 义 SessionFactory : 


此 处 使 用 AnnotationSessionFactoryBean 通 过 annotatedClasses 属 性 指定 注解 模型 来 定义 映 
射 元 数据 ; 


&lt;bean id="sessionFactory" class="org.springframework.orm.hibernate3.annotation.Annotat 
&lt;property name="dataSource" ref="dataSource"/&gt; &]lt;!-- 1、 指 定数 据 源 --&gt; 
&lt;property name="annotatedClasses"&gt; &lt;!1-- 2、 指 定 注 解 类 --&gt; 
&lt;list&gt;&lt;value&gt;cn.javass.spring.chapter8.UserModel28&]lt;/value&gt;&lt;/list 
&lt;/property&gt; 
&lt;property name="hibernateProperties"&gt;&lt;!-- 3、 指 定 Hibernate 属 性 --&gt; 
&lLt;props&gt 
&lt;prop key="hibernate.dialect"&gt; 
org.hibernate.dialect.HSQLDialect 
&lt;/prop&gt; 
&1lt;/props&gt; 
&lt;/property&gt; 
&lt;/beanggt; 


<| i 








2.2、 定 义 HibernateTemplate 


&lt;bean id="hibernateTemplate" class="org.springframework.orm.hibernate3.HibernateTempla 
&lt;property name="sessionFactory" ref="sessionFactory"/&gt; 
&lt;/beanggt; 


a 





3、 最 后 进行 CURD 测 试 吧 : 


@Test 
public void testCURD() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-hibernate2.xml"}; 

ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 

HibernateTemplate hibernateTemplate = ctx.getBean(HibernateTemplate.class); 

UserModel2 model = new UserModel2(); 

model.setMyName("test"); 

insert(hibernateTemplate, model); 

select(hibernateTemplate, model); 

update(hibernateTemplate, model); 

delete(hibernateTemplate, model); 

} 


private void insert(HibernateTemplate hibernateTemplate, UserModel2 model) { 
hibernateTemplate.save(model); 
} 


private void select(HibernateTemplate hibernateTemplate, UserModel2 model) { 
UserModel2 model2 = hibernateTemplate.get(UserModel2.class, 0); 
Assert.assertEquals(model2.getMyName(), model.getMyName()); 
List&lt;UserModel2&gt; list = hibernateTemplate.find("from UserModel2"); 
Assert.assertEquals(list.get(0).getMyName(), model.getMyName()); 

} 

private void update(HibernateTemplate hibernateTemplate, UserModel2 model) { 
model.setMyName("test2"); 
hibernateTemplate.update(model); 

} 

private void delete(HibernateTemplate hibernateTemplate, UserModel2 model) { 
hibernateTemplate.delete(model); 

} 


Spring 集成 Hibernate 进 行 增删 改 查 是 不 是 比 Spring JDBC 方 式 简 单 许 多 ， 而 且 支 持 注解 方式 
配置 映射 元 数据 ， 从 而 减少 映射 定义 配置 文件 数量 。 


私 熟 在 线 原创 内 容 转载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2497.html] 


【第 和 八 章 】 对 ORM 的 支持 之 8.3 集成 iBATIS 一 一 
跟 我 学 spring3 


8.3 集成 iIBATIS 


iBATIS 是 一 个 半自动 化 的 ORM 框 架 ， 需 要 通过 配置 方式 指定 映射 SQL 语 钉 ， 而 不 是 由 框架 本 
身 生 成 〈 如 Hibernate 自 动 生成 对 应 SQL 来 持久 化 对 象 ) ， 即 Hibernate 属 于 全 自动 ORM 框 


架 。 


Spring 提供 对 iBATIS 2.X 的 集成 ， 提 供 一 致 的 异常 体系 、 一 致 的 DAO 访 问 支持 、Spring 管 理事 
务 支持 。 


Spring 2.5.5+ 版 本 支持 iBATIS 2.3+ 版 本 ， 不 支持 低 版 本 。 


8.3.1 如 何 集成 
Spring 通过 使 用 如 下 Bean 进 行 集成 iBATIS : 
。 SqlMapClientFactoryBean : 用 于 集成 iBATIS 。 


configLocation 和 configLocations : 用 于 指定 SQL Map XML 配置 文件 ， 用 于 指定 如 数据 源 等 配 
置信 息 ; 


mappingLocations : 用 于 指定 SQL Map 了 映射 文件 ， 即 半自动 概念 中 的 SQL 语 名 定义 ; 
sqlMapClientProperties : 定义 iBATIS 配置 文件 配置 信息 ; 
dataSource : 定义 数据 源 。 


如 果 在 Spring 配置 文件 中 指定 了 DataSource， 就 不 要 在 iBATIS 配 置 文件 指定 了 ， 否 则 Spring 
配置 文件 指定 的 DataSource 将 履 盖 iBATIS 配 置 文件 中 定义 的 DataSource。 


接 下 来 示例 一 下 如 何 集成 iBATIS : 


1、 准 备 需要 的 jar 包 ， 从 spring-framework-3.0.5.RELEASE-dependencies.zip 中 拷贝 如 下 
jar 包 : 


com.springsource.com.ibatis-2.3.4.726.jar 
2、 对象 模型 定义 ， 此 处 使 用 第 七 章 中 的 UserModel ; 


3、iBATIS 喘 射 定义 (chapter8/sqlmaps/UserSQL.xml) 


<?3XxmlL version="1.0" encoding="UTF-8"?> 
<!IDOCTYPE sqlMap PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-2.dtd"> 
<sqlMap namespace="UserSsQL"> 
<statement id="createTable"> 
<1--id 自 增 主 键 从 0 开始 --> 
<! [cDATA[ 
create memory table test( 
id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, 
name varchar(100)) 
]]> 
</statement> 
<Statement id="dropTable"> 
<![CDATA[ drop table test 1]]> 


</statement> 
<insert id="insert" parameterClass="cn.javass.spring.chapter7.UserModel"> 
<! [cDATA[ 
insert into test(name) values (#myName#) 
]]> 


<selectkey resultClass="int" keyProperty="id" type="post"> 
<!-- 获取 hsqldb 插 入 的 主键 --> 
call identity(); 
<!-- mysql 使 用 select last_insert_id(); 获 取 插 入 的 主键 --> 
</selectkey> 
</insert> 
</sqlMap> 


4、iBATIS 配 置 文件 (chapter8/sql-map-config.xml) 定义 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!IDOCTYPE sqlMapConfig PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN" 
"http://ibatis.apache.org/dtd/sql-map-config-2.dtd"> 


<sqlMapConfig> 
<settings enhancementEnabled="true" useStatementNamespaces="true" 
maxTransactions="20" maxRequests="32" maxSessions="10"/> 
<sqlMap resource="chapter8/sqlmaps/UserSsQL .xml"/> 
</sqlMapConfig> 


5、 数 据 源 定义 ， 此 处 使 用 第 7 章 的 配置 文件 ， 即 “chapter7/applicationContext- 
resources.xml” 文 件 。 


6、SqlMapClient 瑟 置 (chapter8/applicationContext-ibatis.xml) 定义 : 


<bean id="sqlMapClient" 
class="org.springframework.orm.ibatis.SqlMapClientFactoryBean"> 
<1-- 1、 指 定数 据 源 --> 
<property name="dataSource" ref="dataSource"/> 
<1-- 2、 指 定 配置 文件 --> 
<property name="configLocation" value="chapter8/sql-map-config.xml"/> 
</bean> 


7、 获取 SqlMapClient: 


package cn.javass.spring.chapter8; 

// 省 略 import 

public class IbatisTest { 
private static SqlMapClient SqlMapClient 
@BeforeClass 
public static void setUpClass() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-ibatis.xml"}; 

ApplicationContext ctx = new ClassPathxXmlApplicationContext(configLocations); 

sqlMapClient = ctx.getBean(SqlMapClient.class); 


此 处 我 们 使 用 了 chapter7/applicationContext-resources.xml 定 义 的 “dataSource” 数 据 源 ， 通 过 
ctx.getBean(SqlMapClient.class) 获 取 SqlMapClient 。 


8、 通 过 SqlMapClient 创 建 和 删除 表 : 


@Before 

public void setUp() throws SQLException { 
sqlMapClient.update("UserSsQL .createTable"); 

} 


@After 

public void tearDown() throws SQLException { 
sqlMapClient.update("UserSsQL.dropTable"); 

} 


9、 使 用 SqlMapClient 进 行 对 象 持 久 化 : 


@Test 
public void testFirst() throws SQLException { 
UserModel model = new UserModel(); 
model.setMyName("test"); 
SqlMapSession session = null; 
try { 
session = sqlMapClient.openSession(); 
beginTransaction(session); 
session.insert("UserSsQL .insert", model); 
commitTransaction(session); 
} catch (SQLException e) { 
rollbackTransacrion(session); 
throw e; 
} finally { 
closeSession(session); 
} 
} 


private void closeSession(SqlMapSession session) { 
session.close(); 


} 
private void rollbackTransacrion(SqlMapSession session) throws SQLException { 
if(session != nul]1) { 
session.endTransaction(); 
} 
} 


private void commitTransaction(SqlMapSession session) throws SQLException { 
session.commitTransaction(); 
} 


private void beginTransaction(SqlMapSession session) throws SQLException { 
session,.startTransaction(); 
} 


同样 令 人 心烦 的 事务 管理 和 兄长 代码 ，Spring 通 用 提供 了 SqlMapClientTemplate 模 板 类 来 解决 
这 些 问 题 。 


8.3.2 使 用 SqlMapClientTemplate 


SqlMapClientTemplate 模 板 类 同样 用 于 简化 事务 管理 及 常见 操作 ， 类 似 于 JdbcTemplate 模 板 
类 ， 对 于 复杂 操作 通过 提供 SqlMapClientCallback 回 调 接口 来 允许 更 复杂 的 操作 。 


接 下 来 示例 一 下 SqlIMapClientTemplate 的 使 用 : 


@Test 
public void testSqlMapClientTemplate() { 
SqlMapClientTemplate sqlMapClientTemplate = 
new SqlMapClientTemplate(sqlMapClient); 
final UserModel model = new UserModel(); 
model.setMyName( "myName"); 
sqlMapClientTemplate.insert("UserSsQL.insert", model); 
// 通 过 回调 允许 更 复杂 操作 
sqlMapClientTemplate.execute(new SqlMapClientCallback<Void>() { 
@Override 
public Void doInsqlMapClient(SqlMapExecutor session) throws SQLException { 
session.insert("UserSsQL .insert", model); 
return null; 


}}); 


通过 new SqlMapClientTemplate(sqlMapClient) 创 建 HibernateTemplate 模 板 类 对 象 ， 通 过 调用 
模板 类 的 save 方 法 持久 化 对 象 ， 并 且 自 动 享受 到 Spring 管 理事 务 的 好 处 。 


而 且 SqlIMapClientTemplate 提 供 使 用 SqlIMapClientCallback 回 调 接 口 的 方法 execute 用 来 支持 
复杂 操作 ， 当 然 也 自动 享受 到 Spring 管 理事 务 的 好 处 。 


8.3.3 集 成 iBATIS 及 最 佳 实践 


类 似 于 JdbcDaoSupport 类 ，Spring 对 iBATIS 也 提供 了 SqlMapClientDaoSupport 类 来 支持 一 致 
的 数据 库 访 问 。SqlMapClientDaoSupport 也 是 DaoSupport 实 现 : 


接 下 来 示例 一 下 Spring 集 成 iBATIS 的 最 佳 实践 : 
1、 定义 Dao 接 口 ， 此 处 使 用 cn.javass.spring.chapter7.dao.lUserDao : 


2、 定义 Dao 接 口 实现 ， 此 处 是 iBATIS 实 现 : 


package cn.javass.spring.chapter8.dao.ibatis; 
// 省 略 import 
public class UserIbatisDaoImpl extends SqlMapClientDaoSupport 
implements IUserDao { 
@Override 
public void save(UserModel model) { 
getSsqlMapClientTemplate().insert("UserSsQL.insert", model); 


@Override 
public int countAll() { 

return (Integer) getSsqlMapClientTemplate().queryForOobject("UserSsQL.countAll"); 
} 


3、 修 改 iBATS 喘 射 文件 (chapter8/sqlmaps/UserSQL.xml) ， 添 加 countAll 查 询 : 


<select id="countAll" resultClass="java.lang.Integer"> 
<![CDATA[ select count(*) from test ]]> 
</select> 


此 处 注意 首先 iBATIS 实 现 放 在 dao.ibaitis 包 里 ， 其 次 实现 类 命名 如 UserlbatisDaolmpl， 即 
xxxlbatisDaolmpl ， 当 然 如 果 自 己 有 更 好 的 命名 规范 可 以 遵循 自己 的 ， 此 处 只 是 提 个 建议 。 


4、 进 行 资源 配置 ， 使 用 resources/chapter7/applicationContext-resources.xml : 


5、dao 定 义 配置 ， 在 chapter8/applicationContext-ibatis.xml 中 添加 如 下 配置 : 


<bean id="abstractDao" abstract="true"> 
<property name="sqlMapClient" ref="sqlMapClient"/> 
</bean> 
<bean id="userDao" 
class="cn.javass.spring.chapter8.dao.ibatis.UserIbatisDaoImpl" 
parent="abstractDao"/> 


首先 定义 抽象 的 abstractDao， 其 有 一 个 sqlMapClient 属 性 ， 从 而 可 以 让 继承 的 子 类 自动 继承 
sqlMapClient 属 性 注入 ; 然后 定义 UserDao， 且 继承 abstractDao， 从 而 继承 sqlMapClient 注 
入 ; 我 们 在 此 给 配置 文件 命名 为 applicationContext-ibatis.xml 表 示 iBAITIS 实 现 。 


5、 最 后 测试 一 下 吧 (cn.javass.spring.chapter8. lbatisTest ) 


@Test 
public void testBestPractice() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-ibatis.xml"}; 

ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 

IUserDao userDao = ctx.getBean(IUserDao.class); 

UserModel model = new UserModel(); 

model.setMyName("test"); 

userDao.save(model); 

Assert.assertEquals(1, userDao.countAll()); 


和 Spring JDBC 框 架 的 最 佳 实践 完全 一 样 ， 除 了 使 用 applicationContext-ibatis.xml 代 替 了 
applicationContext-jdbc.xml， 其 他 完全 一 样 。 也 就 是 说 ，DAO 层 的 实现 替换 可 以 透明 化 。 


8.3.4Spring+iBATIS 的 CURD 

Spring 集成 iBATIS 进 行 CURD (增删 改 查 ) ， 也 非常 简单 ， 首 先 配 置 映 射 文件 ， 然 后 调用 
SqlMapClientTemplate 相 应 的 函数 进行 操作 即 可 ， 此 处 就 不 介绍 了 。 

8.3.5 集 成 MyBatis 及 最 佳 实践 

(本 笔记 写 于 2010 年 底 ) 


2010 年 4 月 份 iBATIS 团 队 发 布 BATIS 3.0 的 GA 版 本 的 候选 版 本 ， 在 iBATIS 3 中 引入 了 泛 型 、 
注解 支持 等 ， 因 此 需要 Java5+ 才 能 使 用 ， 但 在 2010 年 6 月 16 日 ，iBATIS 团 队 决 定 从 apache 迁 
出 并 迁移 到 Google Code， 并 更 名 为 MyBatis。 目 前 新 网 站 上 文档 并 不 完善 。 


目前 iBATIS 2.x 和 MyBatis 3 不 是 100% 兼 容 的 ， 如 配置 文件 的 DTD 变 更 ，SqlMapClient 直 接 由 
SqlSessionFactory 代 替 了 ， 包 名 也 有 com.ibatis 变 成 org.ibatis 等 等 。 


ibatis 3.x 和 MyBatis 是 兼容 的 ， 只 需要 将 DTD 变 更 一 下 就 可 以 了 。 


感 兴 趣 的 朋友 可 以 到 http:/www.mybatis.org/ 官 网 去 下 载 最 新 的 文档 学 习 ， 作 者 只 使 用 过 
iBATIS2.3.4 及 以 前 版 本 ， 没 在 新 项 目 使 用 过 最 新 的 iBATIS 3.x 和 Mybatis， 因 此 如 果 读 者 需要 
在 项 目 中 使 用 最 新 的 MyBatis， 请 先 做 好 调研 再 使 用 。 


接 下 来 示例 一 下 Spring 集成 MyBatis 的 最 佳 实践 : 


1、 准 备 需要 的 jar 包 ， 到 MyBatis 官 网 下 载 mybatis 3.0.4 版 本 和 mybatis-spring 1.0.0 版 本 ， 
并 拷贝 如 下 jar 包 到 类 路 径 : 


。 mybatis-3.0.4\mybatis-3.0.4.jar // 核 心 MyBatis 包 
。 mybatis-spring-1.0.0\mybatis-spring-1.0.0.jar // 集 成 Spring 包 


2、 对 象 模 型 定义 ， 此 处 使 用 第 七 章 中 的 UserModel ; 


3、MyBatis 映 射 定 义 〈chapter8/sqlmaps/UserSQL-mybatis.xml) 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="UserSQL"> 
<sql id="createTable"> 
<!1--id 自 增 主键 从 0 开始 --> 
<! [cDATA[ 
create memory table test( 
id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, 
name varchar(100)) 
]]> 
</sql> 
<sql id="dropTable"> 
<![CDATA[ drop table test ]]> 
</sql> 
<insert id="insert" parameterType="cn.javass.spring.chapter7.UserModel"> 
<![CDATA[ insert into test(name) values (#{myName}) ]]> 
<selectkey resultType="int" keyProperty="id" order="AFTER"> 
<!-- 获取 hsqldb 插 入 的 主键 --> 
call identity(); 
<1-- mysql 使 用 select last_insert_id(); 获 取 插 入 的 主键 --> 
</selectkey> 
</insert> 
<select id="countAll" resultType="java.lang.Integer"> 
<![CDATA[ select count(*) from test ]]> 
</select> 
</mapper> 


从 映射 定义 中 可 以 看 出 MyBatis 与 iBATIS2.3.4 有 如 下 不 同 : 


。 http://ibatis.apache.org/dtd/sql-map-2.dtd 废弃 ， 而 使 用 http://mybatis.org/dtd/mybatis-3- 
mapper.dtd 。 

。 <sqlMap> 废 弃 ， 而 使 用 <mapper> 标 签 ; 

。 <statement> 废 弃 了 ， 而 使 用 <sq|> 标 签 ; 

。 parameterClass 属 性 废弃， 而 使 用 parameterType 属 性 ; 

e resultClass 属 性 废弃 ， 而 使 用 resultType 属 性 ; 


. myName# 方 式 指定 命名 参数 废弃 ， 而 使 用 并 
{myName} 方 式 。 


3、MyBatis 配 置 文件 (chapter8/sql-map-config-mybatis.xml) 定义 : 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<settings> 
<setting name="cacheEnabled" value="false"/> 
</settings> 
<mappers> 
<mapper resource="chapter8/sqlmaps/UserSsQL-mybatis.xml"/> 
</mappers> 
</configuration> 


从 配置 定义 中 可 以 看 出 MyBatis 与 iBATIS2.3.4 有 如 下 不 同 : 


e http://ibatis.apache.org/dtd/sql-map-config-2.dtd 刻 弃 ， 而 使 
用 http://mybatis.org/dtd/mybatis-3-config.dtd ; 

。 < sqlMapConfig > 废弃 ， 而 使 用 <configuration> ; 

。 settings 属 性 配置 方式 废弃 ， 而 改 用 子 标签 < setting name=".." value=".."/> 方 式 指定 属 
性 ， 且 一 些 属性 被 度 弃 ， 如 maxTransactions ; 

。 < SqlIMap> 废 弃 ， 而 采用 <mappers> 标 签 及 其 子 标签 <mapper> 定 义 。 


4、 定义 Dao 接 口 ， 此 处 使 用 cn.javass.spring.chapter7.dao. IUserDao : 
5、 定 义 Dao 接 口 实现 ， 此 处 是 MyBatis 实 现 : 


package cn.javass.spring.chapter8.dao.mybatis; 
// 省 略 import 
public class UserMybatisDaoImpl extends SqlSessionDaoSupport 
implements IUserDao { 
@Override 
public void save(UserModel model) { 
getSqlSession().insert("UserSsQL.insert", model); 


Q@Override 
public int countAll() { 

return (Integer) getSqlSession().selectOne("UserSQL.countAll"); 
} 


和 |batis 集 成 方式 不 同 的 有 如 下 地 方 : 


。 使 用 SqlSessionDaoSupport 来 支持 一 致 性 的 DAO 访 问 ， 该 类 位 于 
org.mybatis.spring.support 包 中 ， 非 Spring 提供 ; 

e。 使 用 getSqlSession 方 法 获取 SqlSessionTemplate， 在 较 早 版 本 中 是 
getSqlSessionTemplate 方 法 名 ， 不 知 为 什么 改 成 getSqlSession 方 法 名 ， 因 此 这 个 地 方 在 
使 用 时 需要 注意 。 

。 SqlSessionTemplate 是 SqlSession 接 口 的 实现 ， 并 且 自 动 享受 Spring 管理 事务 好 处 ， 
此 从 此 处 可 以 推断 出 为 什么 把 获取 模板 类 的 方法 名 改 为 getSqlSession 而 不 是 
getSqlSession Template。 


6、 进 行 资源 配置 ， 使 用 resources/chapter7/applicationContext-resources.xml : 


7、dao 定 义 配置 ， 在 chapter8/applicationContext-mybatis.xml 中 添加 如 下 配置 : 


<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> 
<property name="dataSource" ref="dataSource"/><!-- 1、 指 定数 据 源 --> 
<property name="configLocation" value="chapter8/sql-map-config-mybatis.xml"/> 
</bean> 
<bean id="abstractDao" abstract="true"> 
<property name="sqlSessionFactory" ref="sqlSessionFactory"/> 
</bean> 
<bean id="userDao" 
class="cn.javass.spring.chapter8.dao.mybatis.UserMybatisDaoImpl1" 
parent="abstractDao"/> 


和 |batis 集 成 方式 不 同 的 有 如 下 地 方 : 


。 SqlMapClient 类 废弃 ， 而 使 用 SqlSessionFactory 代 替 ; 
。 使 用 SqlSessionFactoryBean 进 行 集成 MyBatis。 


首先 定义 抽象 的 abstractDao， 其 有 一 个 sqlSessionFactory 属 性 ， 从 而 可 以 让 继承 的 子 类 自动 
继承 sqlSessionFactory 属 性 注入 ; 然后 定义 UserDao， 且 继承 abstractDao， 从 而 继承 
sqlSessionFactory 注 入 ; 我 们 在 此 给 配置 文件 命名 为 applicationContext-mybatis.xml 表 示 
MyBatis 实 现 。 


8、 最 后 测试 一 下 吧 (cn.javass.spring.chapter8. lbatisTest) 


@Test 
public void testMybatisBestPractice() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-mybatis.xml"}; 

ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 

IUserDao userDao = ctx.getBean(IUserDao.class); 

UserModel model = new UserModel(); 

model.setMyName("test"); 

UserDao ,Save(mode]l) ; 

Assert.assertEquals(1, userDao.countAll()); 


和 Spring 集成 lbatis 的 最 佳 实践 完全 一 样 ， 除 了 使 用 applicationContext-mybatis.xml 代 替 了 
applicationContext-ibatis.xml， 其 他 完全 一 样 ， 且 MyBatis 3.x 与 Spring 整合 只 能 运行 在 
Spring3.X。 

在 写本 书 时 ，MyBatis 与 Spring 集成 所 定义 的 API 不 稳定 ， 且 期 待 Spring 能 在 发 布 新 版 本 时 将 
加 入 对 MyBatis 的 支持 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2498.html] 


【第 八 章 】 对 ORM 的 支持 之 8.4 集成 JPA 一 一 跟 
我 学 Spring3 


8.4 集成 JPA 


JPA 全 称 为 Java 持 久 性 API ava Persistence API) ，JPA 是 Java EE 5 标准 之 一 ， 是 一 个 
ORM 规 范 ， 由 厂商 来 实现 该 规范 ， 目 前 有 Hibernate、OpenJPA、TopLink、EclipseJPA 等 实 
现 。 


8.4.1 如 何 集成 


Spring 目 前 提供 集成 Hibernate、OpenJPA、TopLink、EclipseJPA 四 个 JPA 标 准 实现 。 
Spring 通 过 使 用 如 下 Bean 进 行 集成 JPA (EntityManagerFactory) 


。 LocalEntityManagerFactoryBean : 适用 于 那些 仅 使 用 JPA 进 行 数据 访问 的 项 目 ， 该 
FactoryBean 将 根据 JPA PersistenceProvider 自 动 检测 配置 行 工作 ， 一 般 
从 “META-INF/persistence.xml" 读 取 配 置信 息 ， 这 种 方式 最 简单 ， 但 不 能 设置 Spring 中 定 
义 的 DataSource， 且 不 支持 Spring 管理 的 全 局 事务 ， 而 且 JPA Eee 动 机 
依赖 于 VM agent 从 而 允许 它们 进行 持久 化 类 字 节 码 转 换 (不 同 的 实现 厂商 要 求 不 同 ， 需 
要 时 阅读 其 文档 ) ， 不 建议 使 用 这 种 方式 ; 


persistenceUnitName : 指定 持久 化 单元 的 名 称 ; 


使 用 方式 : 


<bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalEntityManagerFact 
<property name="persistenceUnitName" value="persistenceUnit"/> 
</bean> 


加 ee 于 s 壬 se 和 ee 


。 从 JNDI 中 获取 : 用 于 从 Java EE 服务 器 获取 指定 的 EntityManagerFactory， 这 种 方式 在 进 
行 Spring 事 务 管理 时 一 般 要 使 用 JTA 事 务 管理 





使 用 方式 : 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:jee="http://www.springframework.org/schema/jee" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/jee 
http://www.springframework.org/schema/jee/spring-jee-3.0.xsd"> 
<jee:jndi-lookup id="entityManagerFactory" jndi-name="persistence/persistenceUnit"/> 
</beans> 


1 = 到 





此 处 需要 使 用 “jee” 命 名 标签 ， 且 使 用 <jee:jndi-lookup> 标 签 进 行 JNDI 查 找 ，“jndi-name” 属 性 用 
于 指定 JNDI 名 字 。 


。 LocalContainerEntityManagerFactoryBean : 适用 于 所 有 环境 的 FactoryBean， 能 全 面 
控制 EntityManagerFactory 配 置 ,如 指定 Spring 定义 的 DataSource 等 等 。 


persistenceUnitManager : 用 于 获取 JPA 持 久 化 单元 ， 默 认 实 现 
DefaultPersistenceUnitManager 用 于 解决 多 配置 文件 情况 


dataSource : 用 于 指定 Spring 定 义 的 数据 源 ; 


persistenceXmlLocation : 用 于 指定 JPA 配 置 文件 ， 对 于 对 配置 文件 情况 请 选择 设置 
persistenceUnitManager 属 性 来 解决 ; 


persistenceUnitName : 用 于 指定 持久 化 单元 名 字 ; 


persistenceProvider : 用 于 指定 持久 化 实现 厂商 类 ; 如 Hibernate 为 
org.hibernate.ejb.HibernatePersistence 类 ; 


jpaVendorAdapter : 用 于 设置 实现 厂商 JPA 实 现 的 特定 属性 ， 如 设置 Hibernate 的 是 否 自 动 生 
成 DDL 的 属性 generateDdl ; 这 些 属性 是 厂商 特定 的 ， 因 此 最 好 在 这 里 设置 ; 目前 Spring 提供 
HibernateJpaVendorAdapter 、OpenJpaVendorAdapter、EclipseLinkJpaVendorAdapter、 
TopLinkJpaVendorAdapter、OpenJpaVendorAdapter 四 个 实现 。 其 中 最 重要 的 属性 

是 “database”， 用 来 指定 使 用 的 数据 库 类 型 ， 从 而 能 根据 数据 库 类 型 来 决定 比如 如 何 将 数据 
库 特 定 异 常 转 换 为 Spring 的 一 致 性 异常 ， 目 前 支持 如 下 数据 库 (DB2、DERBY 、H2、 
HSQL、INFORMIX、MYSQL 、ORACLE 、POSTGRESQL 、SQL SERVER、 

SYBASE) 。 


jpaDialect : 用 于 指定 一 些 高 级 特性 ， 如 事务 管理 ， 获 取 具 有 事务 功能 的 连接 对 象 等 ， 目 前 
Spring 提供 HibernateJpaDialect、OpenJpaDialect 、EclipseLinkJpaDialect、 
TopLinkJpaDialect、 和 和 DefaultJpaDialect 实 现 ， 注 意 DefaultJpaDialect 不 提供 任何 功能 ， 因 此 
在 使 用 特定 实现 厂商 JPA 实 现时 需要 指定 JpaDialect 实 现 ， 如 使 用 Hibernate 就 使 用 
HibernateJpaDialect。 关 指定 jpaVendorAdapter 属 性 时 可 以 不 指定 jpaDialect， 会 自动 设置 
相应 的 JpaDialect 实 现 ; 


jpaProperties 和 jpaPropertyMap : 指定 JPA 属 性 ; 如 Hibernate 中 指定 是 否 显示 SQL 
的 “hibernate.show_sqpP 属 性， 对 于 jpaProperties 设 置 的 属性 自动 会 放 进 jpaPropertyMap 中 ; 


loadTimeWeaver : 用 于 指定 LoadTimeWeaver 实 现 ， 从 而 允许 JPA 加 载 时 修改 相应 的 类 文 
件 。 具 体 使 用 得 参考 相应 的 JPA 规 范 实现 厂商 文档 ， 如 Hibernate 就 不 需要 指定 
loadTimeWeaver ° 


接 下 来 学 习 一 下 Spring 如 何 集成 JPA 吧 : 


1、 准 备 jar 包 ， 从 下 载 的 hibernate-distribution-3.6.0.Final 包 中 获取 如 下 Hibernate 需要 的 
jar 包 从 而 支持 JPA : 


。 libjpa\hibernate-jpa-2.0-api-1.0.0.Final.jar /用 于 支持 JPA 


2、 对 象 模 型 定义 ， 此 处 使 用 UserModel2 : 


package cn.javass.spring.chapter8; 
// 省 略 import 
@Entity 
@Table(name = "test") 
public class UserModel2 { 
@Id @GeneratedValue(strategy = GenerationType.AUTO) 
private int id; 
@Column(name = "name") 
private String myName; 
// 省 咯 getter 和 setter 


注意 此 处 使 用 的 所 有 注解 都 是 位 于 javax.persistence 包 下 ， 如 使 用 
@org.hibernate.annotations.Entity 而 非 @javax.persistence. Entity 将 导致 JPA 不 能 正常 工 
作 。 


1、JPA 配 置 定义 (chapter8/persistence.xml) ， 定 义 对 象 和 数据 库 之 间 的 映射 : 


<?XxmlL version="1.0" encoding="UTF-8"?> 

<persistence version="1.0" 
xmlns="http://java.sun.com/xml/ns/persistence" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http: 
<persistence-unit name="persistenceUnit" transaction-type="RESOURCE_LOCAL"/> 

</persistence> 


一抹 一 


在 JPA 配 置 文件 中 ， 我 们 指定 要 持久 化 单元 名 字 ， 和 事务 类 型 ， 其 他 都 将 在 Spring 中 配置 。 





2、 数据 源 定义 ， 此 处 使 用 第 7 章 的 配置 文件 ， 即 “chapter7/applicationContext- 
resources.xml” 文 件 。 


3、EntityManagerFactory 配 置 定 义 (chapter8/applicationContext-jpa.xml) 


<bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntity 
<property name="dataSource" ref="dataSource"/> 
<property name="persistenceXmlLocation" value="chapter8/persistence.xml"/> 
<property name="persistenceUnitName" value="persistenceUnit"/> 
<property name="persistenceProvider" ref="persistenceProvider"/> 
<property name="jpaVendorAdapter" ref="jpaVendorAdapter"/> 
<property name="jpaDialect" ref="jpaDialect"/> 
<property name="jpaProperties"> 
<props> 
<prop key="hibernate.show_ sql">true</prop> 
</props> 
</property> 
</bean> 
<bean id="persistenceProvider" class="org.hibernate.ejb.HibernatePersistence"/> 








<bean id="jpaVendorAdapter" class="org.springframework.orm.jpa.vendor.HibernateJpaVendorA 
<property name="generateDdl" value="false" /> 
<property name="database" value="HSQL"/> 

</bean> 

<bean id="jpaDialect" class="org.springframework.orm.jpa.vendor.HibernateJpaDialect"/> 


恒生 


. Fovale om/n er Mana a oy een 定 使 用 本 地 容器 管理 
EntityManagerFactory， 从 而 进行 细 粒 度 控 制 ; 

。 dataSource 属 性 指定 使 用 Spring 定义 的 数据 源 ; 

。 persistenceXmlLocation 指 定 JPA 配 置 文件 为 chapter8/persistence.xml， 且 该 配置 文件 
非常 简单 ， 具 体 配 置 完全 在 Spring 中 进行 ; 

。 persistenceUnitName 指 定 持久 化 单元 名 字 ， 即 JPA 配 置 文件 中 指定 的 ; 

。 persistenceProvider: 指 定 JPA 持 久 化 提供 商 ， 此 处 使 用 Hibernate 实 现 
HibernatePersistence 类 ; 

。 jpaVendorAdapter : 指定 实现 厂商 专用 特性 ， 即 generateDdl= false 表 示 不 自动 生成 
DDL，database= HSQL 表 示 使 用 hsqldb 数 据 库 ; 

。 jpaDialect : 如 果 指 定 jpaVendorAdapter 此 属性 可 选 ， 此 处 为 HibernateJpaDialect ; 

。 jpaProperties : 此 处 指定 "hibernate.show sql =true" 表 示 在 日 志 系统 debug 级 别 下 将 打 
印 所 有 生成 的 SQL 。 





4、 获 取 EntityManagerFactory : 


package cn.javass.spring.chapter8; 

// 省 略 import 

public class JPATeSst { 
private static EntityManagerFactory entityManagerFactory; 
@BeforeClass 
public static void setUpClass() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-jpa.xml"}; 

ApplicationContext ctx = new ClassPathXmlApplicationContext(configLocations); 

entityManagerFactory = ctx.getBean(EntityManagerFactory.class); 


此 处 我 们 使 用 了 chapter7/applicationContext-resources.xml 定 义 的 “dataSource” 数 据 源 ， 通 过 
ctx.getBean(EntityManagerFactory.class) 获 取 EntityManagerFactory。 


5、 通 过 EntityManagerFactory 获 取 EntityManager 进 行 创 建 和 删除 表 : 


@Before 

public void setUp() throws SQLException { 
//id 自 增 主键 从 0 开始 
String createTableSql = "create memory table test" + "(id int GENERATED BY DEFAULT AS 
executeSsql(createTableSq1); 


@After 

public void tearDown() throws SQLException { 
String dropTabJleSdql = "drop table test",; 
executeSql(dropTableSdq1) ; 


} 


private void executeSql(String sql) throws SQLException { 
EntityManager em = entityManagerFactory.createEntityManager(); 
beginTransaction(em); 
em.createNativeQuery(sql1).executeUpdate( ); 
commitTransaction(em); 
closeEntityManager (em); 

} 

private void closeEntityManager(EntityManager em) { 
em.close(); 

} 

private void rollbackTransacrion(EntityManager em) throws SQLException { 
if(em != nul1) { 

em.getTransaction().rollback(); 

} 


} 

private void commitTransaction(EntityManager em) throws SQLException { 
em.getTransaction().commit(); 

} 


private void beginTransaction(EntityManager em) throws SQLException { 
em.getTransaction().begin(); 
} 


国定 一 2 


使 用 EntityManagerFactory 创 建 EntityManager， 然 后 通过 EntityManager 对 象 的 
createNativeQuery 创 建 本 地 SQL 执行 创建 和 删除 表 。 





6、 使 用 EntityManagerFactory 获 取 EntityManager 对 象 进 行 持久 化 数据 : 


@Test 
public void testFirst() throws SQLException { 
UserModel2 model = new UserModel2(); 
model.setMyName("test"); 
EntityManager em = null; 
try { 
em = entityManagerFactory.createEntityManager(); 
beginTransaction(em); 
em.persist(model); 
commitTransaction(em); 
} catch (SQLException e) { 
rollbackTransacrion(em); 
throw e; 
} finally { 
closeEntityManager (em); 
} 


使 用 EntityManagerFactory 获 取 EntityManager 进 行 操作 ， 看 到 这 还 能 忍受 兄长 的 代码 和 事 
务 管理 吗 ? Spring 同 样 提供 JpaTemplate 模 板 类 来 简化 这 些 操 作 。 


大 家 有 没有 注意 到 此 处 的 模型 对 象 能 自动 映射 到 数据 库 ， 这 是 因为 Hibernate JPA 实 现 默 认 自 
动 扫描 类 路 径 中 的 @Entity 注 解 类 及 *.hbm.xml 映 射 文件 ， 可 以 通过 更 改 Hibernate JPA 属 

性 “hibernate.ejb.resource_scanner， 并 指定 org.hibernate.ejb.packaging.Scanner 接 口 实现 
来 定制 新 的 扫描 策略 。 


8.4.2 使 用 JpaTemplate 


JpaTemplate 模 板 类 用 于 简化 事务 管理 及 常见 操作 ， 类 似 于 JdbcTemplate 模 板 类 ， 对 于 复杂 操 
作 通 过 提供 JpaCallback 回 调 接口 来 允许 更 复杂 的 操作 。 


接 下 来 示例 一 下 JpaTemplate 的 使 用 : 


A 


1、 修 改 Spring 配 置 文件 (chapter8/applicationContext-jpa.xml) ， 添 加 JPA 事 务 管理 器 : 


<bean id="txManager" class="org.springframework.orm.jpa.JpaTransactionManager"> 
<property name="entityManagerFactory" ref="entityManagerFactory"/> 
</bean> 


。 txManager : 指定 事务 管理 器 ，JPA 使 用 JpaTransactionManager 事 务 管理 器 实现 ， 通 过 
entityManagerFactory 指 定 EntityManagerFactory ; 用 于 支持 Java SE 环境 的 JPA 扩 展 的 
持久 化 上 下 文 (EXTENDED Persistence Context) 。 


2、 修 改 JPATest 类 ， 添 加 类 变量 ctx， 用 于 后 边 使 用 其 获取 事务 管理 器 使 用 : 


package cn.javass.spring.chapter8; 
public class JPATeSst { 
private static EntityManagerFactory entityManagerFactory; 
private static ApplicationContext ctx; 
@BeforeClass 
public static void beforeClass() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-jpa.xml"}; 

ctx = new ClassPpathxmlApplicationContext(configLocations); 

entityManagerFactory = ctx.getBean(EntityManagerFactory.class); 


cc 


3) JpaTemplate 模 板 类 使 用 : 


@Test 
public void testJpaTemplate() { 
final JpaTemplate jpaTemplate = new JpaTemplate(entityManagerFactory); 
final UserModel2 model = new UserModel2(); 
model.setMyName("test1"); 
PlatformTransactionManager txManager = ctx.getBean(PlatformTransactionManager .class); 
new TransactionTemplate(txManager) .executel( 
new TransactionCallback<Void>() { 
@Override 
public Void doInTransaction(TransactionStatus status) { 
jpaTemplate.persist(model); 
return null; 


} 
}); 
String COUNT_ALL = "select count(*) from UserModel"; 
Number count = (Number) jpaTemplate.find(COUNT_ALL).get(0); 
Assert.assertEquals(1, count.intValue()); 


| 


。 jpaTemplate : 可 通过 new JpaTemplate(entityManagerFactory) 方 式 创 建 ; 

。 txManager : 通过 ctx.getBean(PlatformTransactionManager.class) 获 取 事 务 管理 器 ; 

。 TransactionTemplate : 通过 new TransactionTemplate(txManagem 创 建 事务 模板 对 象 ， 
并 通过 execute 方 法 执行 TransactionCallback 回 调 中 的 dolnTransaction 方 法 中 定义 需要 执 
行 的 操作 ， 从 而 将 由 模板 类 通过 txManager 事 务 管理 器 来 进行 事务 管理 ， 此 处 是 调用 
jpaTemplate 对 象 的 persist 方 法 进行 持久 化 ; 

。 jpaTemplate.persist() : 根据 JPA 规 范 ， 在 JPA 扩 展 的 持久 化 上 下 文 ， 该 操作 必须 运行 在 
事务 环境 ， 还 有 persist() 、merge()、remove() 操 作 也 必须 运行 在 事务 环境 ; 

。 jpaTemplate.find() : 根据 JPA 规 范 ， ee ， 还 有 find()、 
getReference()、refresh()、detach() 和 查询 操作 都 无 需 运行 在 事务 环境 。 


实例 与 Hibernate 和 lbatis 有 所 区 别 ， 通 过 JpaTemplate 模 板 类 进行 如 持久 化 等 操作 时 必须 有 
运行 在 事务 环境 中 ， 否 则 可 能 抛 出 如 下 异常 或 警告 : 


e。 “javax.persistence.TransactionRequiredException : Executing an update/delete 
query”: 表示 没有 事务 支持 ， 不 能 执行 更 新 或 删除 操作 ; 

。 警告 “delaying identity-insert due to no transaction in progress”: 需要 在 日 志 系 统 
启动 debug 模 式 才 能 看 到 ， 表 示 在 无 事务 环境 中 无 法 进行 持久 化 ， 而 选择 了 延迟 标识 插 
入 o 


以 上 异常 和 警告 是 没有 事务 造成 的 ， 也 是 最 让 人 困惑 的 问题 ， 需 要 大 家 注意 。 


8.4.3 集成 JPA 及 最 佳 实践 


类 似 于 JdbcDaoSupport 类 ，Spring 对 JPA 也 提供 了 JpaDaoSupport 类 来 支持 一 致 的 数据 库 访 
问 。JpaDaoSupport 孔 是 DaoSupport 实 现 : 


接 下 来 示例 一 下 Spring 集成 JPA 的 最 佳 实践 : 


1、 定义 Dao 接 口 ， 此 处 使 用 cn.javass.spring.chapter7.dao. IUserDao : 


2、 定义 Dao 接 口 实现 ， 此 处 是 JPA 实 现 : 


package cn.javass.spring.chapter8.dao.jpa; 
// 省 略 import 
@Transactional(propagation = Propagation,.REQUIRED ) 
public class UserJpaDaoImpl] extends JpaDaoSupport implements IUserDao { 
private static final String COUNT_ALL_ JPAQL = "select count(*) from UserModel"; 
@Override 
public void save(UserModel model) { 
getJpaTemplate().persist(model); 


@Override 
public int countAll() { 
Number count = 
(Number) getJpaTemplate().find(COUNT_ALL_JPAQL) .get(0); 
return count.intValue(); 


此 处 注意 首先 JPA 实 现 放 在 dao.jpa 包 里 ， 其 次 实现 类 命名 如 UserJpaDaolmpl， 即 
xxxJpaDaolmpl， 当 然 如 果 自 己 有 更 好 的 命名 规范 可 以 遵循 自己 的 ， 此 处 只 是 提 个 建议 。 


另外 在 类 上 添加 了 @Transactional 注 解 表示 该 类 的 所 有 方法 将 在 调用 时 。 ee ， 
propagation 传 播 属 性 为 Propagation.REQUIRED 表 示 事 务 是 必需 的 ， 如 果 执 行 该 类 的 方法 没 
有 开启 事务 ， 将 开启 一 个 新 的 事务 。 


3、 进 行 资源 配置 ， 使 用 resources/chapter7/applicationContext-resources.xml : 
4、dao 定 义 配置 ， 在 chapter8/applicationContext-jpa.xml 中 添加 如 下 配置 


4.1、 首 先 添加 tx 命名 空间 用 于 支持 事务 


<?XxmlL version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd"> 


4.2、 为 @Transactional 注 解 事务 开启 事务 支持 : 


<tx:annotation-driven transaction-manager="txManager"/> 


只 为 类 添加 @Transactional 注解 是 不 能 支持 事务 的 ， 需 要 通过 <tx:annotation-driven> 标 签 来 
开启 事务 支持 ， 其 中 txManager 属 性 指定 事务 管理 器 。 


4.3、 配 置 DAO Bean : 


<bean id="abstractDao" abstract="true"> 
<property name="entityManagerFactory" ref="entityManagerFactory"/> 
</bean> 
<bean id="userDao" 
class="cn.javass.spring.chapter8.dao.jpa.UserJpaDaoImpl" 
parent="abstractDao"/> 


首先 定义 抽象 的 abstractDao， 其 有 一 个 entityManagerFactory 属 性 ， 从 而 可 以 让 继承 的 子 类 
自动 继承 entityManagerFactory 属 性 注入 ; 然后 定义 UserDao， 且 继承 abstractDao， 从 而 继承 
entityManagerFactory 注 入 ; 我 们 在 此 给 配置 文件 命名 为 applicationContext-jpa.xml 表 示 JPA 
实现 。 


5、 最 后 测试 一 下 吧 (cn.javass.spring.chapter8. JPATest ) 


@Test 
public void testBestPractice() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter8/applicationContext-jpa.xml"}; 

ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 

IUserDao userDao = ctx.getBean(IUserDao.class); 

UserModel model = new UserModel(); 

model.setMyName("test"); 

userDao.save(model); 

Assert.assertEquals(1, userDao.countAll()); 


和 Spring JDBC 框 架 的 最 佳 实践 完全 一 样 ， 除 了 使 用 applicationContext-jpa.xml 代 替 了 
applicationContext-jdbc.xml， 其 他 完全 一 样 。 也 就 是 说 ，DAO 层 的 实现 替换 可 以 透明 化 。 


还 有 与 集成 其 他 ORM 框 架 不 同 的 是 JPA 在 进行 持久 化 或 更 新 数据 库 操 作 时 需要 事务 支持 。 


8.4.4 Spring+JPA 的 CRUD 


Spring+JPA CRUD (增删 改 查 ) 也 相当 简单 ， 让 我 们 直接 看 具体 示例 吧 


@Test 
public void testCRUD( ) { 
PlatformTransactionManager txManager = ctx.getBean(PlatformTransactionManager.class); 
final JpaTemplate jpaTemplate = new JpaTemplate(entityManagerFactory); 
TransactionTemplate tansactionTemplate = new TransactionTemplate(txManager ); 
tansactionTemplate.execute(new TransactionCallback<Void>() { 
@Override 
public Void doInTransaction(TransactionStatus status) { 
UserModel model = new UserModel(); 
model.setMyName("test"); 
// 新 增 
jpaTemplate.persist(model); 
// 修 改 
model.setMyName("test2"); 
jpaTemplate.flush();// 可 选 
// 查 询 
String sql = "from UserModel where myName=?"; 
List result = jpaTemplate.find(sql, "test2"); 
Assert.assertEquals(1, result.size()); 
// 删 除 
jpaTemplate.remove(model); 
return null; 
} 
}); 
} 


[m= 二 


。 对 于 增删 改 必 须 运 行 在 事务 环境 ， 因 此 我 们 使 用 TransactionTemplate 事 务 模板 类 来 支持 
事务 。 

e 持久 化 : 使 用 JpaTemplate 类 的 persist 方 法 持久 化 模型 对 象 ; 

e 更 新 : 对 于 持久 化 状态 的 模型 对 象 直接 修改 属性 ， 调 用 flush 方 法 即 可 更 新 到 数据 库 ， 在 
一 些 场合 时 flush 方 法 调用 可 选 ， 如 执行 一 个 查询 操作 等 ， 具 体 请 参考 相关 文档 ; 

。 查询 : 可 以 使 用 find 方 法 执行 JPA QL 查询 ; 

。 删除 : 使 用 remove 方 法 删除 一 个 持久 化 状态 的 模型 对 象 。 


Spring 集 成 JPA 进 行 增删 改 查 也 相当 简单 ， 但 本 文 介绍 的 稍微 复杂 一 点 ， 因 为 牵扯 到 编程 式 事 
务 ， 如 果 采 用 声明 式 事务 将 和 集成 Hibernate 方 式 一 样 简洁 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2500.html] 
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9.1 数据 库 事务 概述 


人 割 的 ， 即 要 么 所 有 操 
作 都 做 ， 要 么 所 有 操作 都 不 做 ， 这 就 是 事务 。 


事务 必需 满足 ACID (原子 性 、 一 致 性 、 隔 离 性 和 持久 性 ) 特性 ， 缺 一 不 可 : 


。 原子 性 (Atomicity) : 即 事务 是 不 可 分 割 的 最 小 工作 单元 ， 事 务 内 的 操作 要 么 全 做 ， 要 
么 全 不 做 ; 

。 一 致 性 (Consistency) : 在 事务 执行 前 数据 库 的 数据 处 于 正确 的 状态 ， 而 事务 执行 完 
成 后 数据 库 的 数据 还 是 处 于 正确 的 状态 ， 即 数据 完整 性 约束 没有 被 破坏 ; 如 银行 转帐 ，A 
转帐 给 B， 必 须 保证 A 的 钱 一 定 转 给 B， 一 定 不 会 出 现 A 的 钱 转 了 但 B 没 收 到 ， 否 则 数据 库 
的 数据 就 处 于 不 一 致 ( 不 正确 ) 的 状态 。 

。 隔离 性 (Isolation ) : 并 发 事务 执行 之 间 无 影响 ， 在 一 个 事务 内 部 的 操作 对 其 他 事务 
不 产生 影响 ， 这 需要 事务 隔离 级 别 来 指定 隔离 性 ; 

。 持久 性 (Durability) : 事务 一 旦 执行 成 功 ， 它 对 数据 库 的 数据 的 改变 必须 是 永久 的 ， 不 
会 因 比 如 遇 到 系统 故障 或 断 电 造成 数据 不 一 致 或 丢失 。 


在 实际 项 目 开发 中 数据 库 操作 一 般 都 是 并 发 执行 的 ， 即 有 多 个 事务 并 发 执行 ， 并 发 执行 就 可 
能 遇 到 问题 ， 目 前 常见 的 问题 如 下 : 


。 丢失 更 新 : 两 个 事务 同时 更 新 一 行 数据 ， 最 后 一 个 事务 的 更 新 会 覆盖 掉 第 一 个 事务 的 更 
新 ， 从 而 导致 第 一 个 事务 更 新 的 数据 丢失 ， 这 是 由 于 没有 加 锁 造 成 的 ; 

e 脏 读 : 一 个 事务 看 到 了 另 一 个 事务 未 提交 的 更 新 数据 ; 

e 不 可 重复 读 : 在 同一 事务 中 ， 多 次 读 取 同 一 数据 却 返 回 不 同 的 结果 ; 也 就 是 有 其 他 事务 
更 改 了 这 些 数据 ; 

。 幻 读 : 一 个 事务 在 执行 过 程 中 读 取 到 了 另 一 个 事务 已 提交 的 插入 数据 ; 即 在 第 一 个 事务 

开始 时 读 取 到 一 批 数 据 ， ER ， 此 时 第 一 个 事务 又 

读 取 这 批 数 据 但 发 现 多 了 一 条 ， 即 好 像 发 生 幻觉 一 样 。 


为 了 解决 这 些 并 发 问题 ， 需 要 通过 数据 库 隔 离 级 别 来 解决 ， 在 标准 SQL 规范 中 定义 了 四 种 隔 
离 级 别 : 


。 未 提交 读 (Read Uncommitted) : 最 低 隔 离 级 别 ， 一 个 事务 能 读 取 到 别 的 事务 未 提交 
的 更 新 数据 ， 很 不 安全 ， 可 能 出 现 丢 失 更 新 、 脏 读 、 不 可 重复 读 、 幻 读 ; 

。 提交 读 (Read Committed) : 一 个 事务 能 读 取 到 别 的 事务 提交 的 更 新 数据 ， 不 能 看 到 
未 提交 的 更 新 数据 ， 不 可 能 可 能 出 现 丢 失 更 新 、 脏 读 ， 但 可 能 出 现 不 可 重复 读 、 幻 读 ; 


。 可 重复 读 (Repeatable Read) : 保证 同一 事务 中 先后 执行 的 多 次 查询 将 返回 同一 结 
果 ， 不 受 其 他 事务 影响 ， 可 能 可 能 出 现 丢 失 更 新 、 脏 读 、 不 可 重复 读 ， 但 可 能 出 现 幻 
读 ; 

。 序列 化 (Serializable) : 最 高 隔离 级 别 ， 不 允许 事务 并 发 执行 ， 而 必须 串 行 化 执行 ， 最 
安全 ， 不 可 能 出 现 更 新 、 脏 读 、 不 可 重复 读 、 幻 读 。 


隔离 级 别 越 高 ， 数 据 库 事务 并 发 执行 性 能 越 差 ， 能 处 理 的 操作 越 少 。 因 此 在 实际 项 目 开 发 中 
为 了 考虑 并 发 性 能 一 般 使 用 提交 读 隔离 级 别 ， 它 能 避免 丢失 更 新 和 脏 读 ， 尽 管 不 可 重复 读 和 
幻 读 不 能 避免 ， 但 可 以 在 可 能 出 现 的 场合 使 用 悲观 锁 或 乐观 锁 来 解决 这 些 问 题 。 


9.1.1 事务 类 型 
数据 库 事 务 类 型 有 本 地 事务 和 分 布 式 事务 : 


。 本 地 事务 : 就 是 普通 事务 ， 能 保证 单 台 数据 库 上 的 操作 的 ACID， 被 限定 在 一 台数 据 库 
< 

e 分 布 式 事务 : 涉及 两 个 或 多 个 数据 库 源 的 事务 ， 即 跨越 多 台 同 类 或 异类 数据 库 的 事务 
(由 每 台数 据 库 的 本 地 事务 组 成 的 ) ， 分 布 式 事务 旨 在 保证 这 些 本 地 事务 的 所 有 操作 的 
ACID ， 使 事务 可 以 跨越 多 台数 据 库 ; 


Java 事 务 类 型 有 JDBC 事 务 和 JTA 事 务 : 


e。 JDBC 事 务 : 就 是 数据 库 事务 类 型 中 的 本 地 事务 ， 通 过 Connection 对 象 的 控制 来 管理 事 
名 。 
pS 

。 JTA 事 务 : JTA 指 Java 事 务 API(Java Transaction APIl)， 是 Java EE 数据 库 事务 规范 ， 
JTA 只 提供 了 事务 管理 接口 ， 由 应 用 程序 服务 器 厂商 (如 WebSphere Application 


Server) 提供 实现 ，JTA 事 务 比 JDBC 更 强大 ， 支 持 分 布 式 事务 。 
Java EE 事务 类 型 有 本 地 事务 和 全 局 事务 : 


e@ 本 地 事务 : 使 用 JDBC 编 程 实现 事务 ; 
e 全 局 事务 : 由 应 用 程序 服务 器 提供 ， 使 用 JTA 事 务 ; 


按 是 否 通 过 编程 实现 事务 有 声明 式 事务 和 编程 式 事务 ; 

。 声明 式 事务 : 通过 注解 或 XML 配置 文件 指定 事务 信息 ; 

。 编程 式 事务 : 通过 编写 代码 实现 事务 。 

9.1.2 Spring 提供 的 事务 管理 

Spring 框架 最 核心 功能 之 一 就 是 事务 管理 ， 而 且 提 供 一 致 的 事务 管理 抽象 ， 这 能 帮助 我 们 : 


。 提供 一 致 的 编程 式 事务 管理 API， 不 管 使 用 Spring JDBC 框 架 还 是 集成 第 三 方 框架 使 用 该 
API 进 行事 务 编程 ; 
。 无 侵入 式 的 声明 式 事务 支持 。 


跟 我 学 Spring 系列 


Spring 支 持 声 明 式 事务 和 编程 式 事务 事务 类 型 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2502.html] 
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【第 九 章 】 Spring 的 事务 之 9.2 事务 管理 器 一 一 
跟 我 学 spring3 


9.2.1 概述 


Spring 框架 支持 事务 管理 的 核心 是 事务 管理 器 抽象 ， 对 于 不 同 的 数据 访问 框架 (如 
Hibernate ) 通过 实现 策略 接口 PlatformTransactionManager， 从 而 能 支持 各 种 数据 访问 框架 
的 事务 管理 ，PlatformTransactionManager 接 口 定 义 如 下 : 


public interface PlatformTransactionManager { 
TransactionStatus getTransaction(TransactionDefinition definition) throws Transact 
void commit(TransactionStatus status) throws TransactionException; 
void rollback(TransactionStatus status) throws TransactionException; 


} 


融 和 


。 getTransaction() : 返回 一 个 已 经 激活 的 事务 或 创建 一 个 新 的 事务 (根据 给 定 的 
TransactionDefinition 类 型 参数 定义 的 事务 属性 ) ， 返 回 的 是 TransactionStatus 对 象 代表 
了 当前 事务 的 状态 ， 其 中 该 方法 抛 出 TransactionException (未 检查 异常 ) 表示 事务 由 于 
某 种 原因 失败 。 

。 commit() : 用 于 提交 TransactionStatus 参 数 代表 的 事务 ， 具 体 语 义 请 参考 Spring 





Javadoc ; 
。 rollback() : 用 于 回 滚 TransactionStatus 参 数 代 表 的 事务 ， 具 体 语义 请 参考 Spring 
Javadoc。 


TransactionDefinition 接 口 定 义 如 下 : 


public interface TransactionDefinition { 
int getPropagationBehavior(); 
int getIsolationLevel(); 
int getTimeout(); 
boolean isReadonly(); 
String getName(); 


。 getPropagationBehavior() : 返回 定义 的 事务 传播 行为 ; 
。 getlsolationLevel() : 返回 定义 的 事务 隔离 级 别 ; 
getTimeout() : 返回 定义 的 事务 超时 时 间 ; 

。 isReadOnly() : 返回 定义 的 事务 是 否 是 只 读 的 ; 
getName() : 返回 定义 的 事务 名 字 。 


TransactionStatus 接 口 定 义 如 下 : 


public interface TransactionStatus extends SavepointManager { 


boolean isNewTransaction(); 
boolean hasSsavepoint(); 
void setRollbackonly(); 
boolean isRollbackonly(); 
void flush(); 

boolean isCompleted(); 


isNewTransaction() : 返回 当前 事务 状态 是 否 是 新 事务 ; 

hasSavepoint() : 返回 当前 事务 是 否 有 保存 点 ; 

setRollbackOnly() : 设置 当前 事务 应 该 回 滚 : 

isRollbackOnly(() : 返回 当前 事务 是 否 应 该 回 滚 ; 

flush() : 用 于 刷新 底层 会 话 中 的 修改 到 数据 库 ， 一 般 用 于 刷新 如 Hibernate/JPA 的 会 话 ， 
可 能 对 如 JDBC 类 型 的 事务 无 任何 影响 ; 

isCompleted(): 当 前 事务 否 已 经 完成 。 


9.2.2 内 置 事务 管理 器 实现 


Spring 提供 了 许多 内 置 事务 管理 器 实现 : 


DataSourceTransactionManager : 位 于 org.springframework.jdbc.datasource 包 中 ， 数 
据 源 事务 管理 器 ， 提 供 对 单个 javax.sql.DataSource 事 务 管 理 ， 用 于 Spring JDBC 抽 象 框 
架 、iBATIS 或 MyBatis 框 架 的 事务 管理 ; 

JdoTransactionManager : 位 于 org.springframework.orm.jdo 包 中 ， 提 供 对 单个 
javax.jdo.PersistenceManagerFactory 事 务 管理 ， 用 于 集成 JDO 框 架 时 的 事务 管理 ; 
JpaTransactionManager : 位 于 org.springframework.orm.jpa 包 中 ， 提 供 对 单个 
javax.persistence.EntityManagerFactory 事 务 支持 ， 用 于 集成 JPA 实 现 框架 时 的 事务 管 

理 ; 

HibernateTransactionManager : 位 于 org.springframework.orm.hibernate3 包 中 ， 提 供 
对 单个 org.hibernate.SessionFactory 事 务 支持 ， 用 于 集成 Hibernate 框 架 时 的 事务 管理 ; 
该 事务 管理 器 只 支持 Hibernate3+ 版 本 ， 且 Spring3.0+ 版 本 只 支持 Hibernate 3.2+ 版 本 ; 
JtaTransactionManager : 位 于 org.springframework.transaction.jta 包 中 ， 提 供 对 分 布 式 
事务 管理 的 支持 ， 并 将 事务 管理 委托 给 Java EE 应 用 服务 器 事务 管理 器 ; 
OC4JjtaTransactionManager : 位 于 org.springframework.transaction.jta 包 中 ，Spring 
提供 的 对 OC4J10.1.3+ 应 用 服务 器 事务 管理 器 的 适配器 ， 此 适配器 用 于 对 应 用 服务 器 提供 
的 高 级 事务 的 支持 ; 

WebSphereUowTransactionManager : 位 于 org.springframework.transaction.jta 包 中 ， 
Spring 提 供 的 对 WebSphere 6.0+ 应 用 服务 器 事务 管理 器 的 适配器 ， 此 适配器 用 于 对 应 用 
服务 器 提供 的 高 级 事务 的 支持 ; 

WebLogicJtaTransactionManager : 位 于 org.springframework.transaction.jta 包 中 ， 
Spring 提供 的 对 WebLogic 8.1+ 应 用 服务 器 事务 管理 器 的 适配器 ， 此 适配器 用 于 对 应 用 服 
务 器 提供 的 高 级 事务 的 支持 。 


Spring 不 仅 提 供 这 些 事务 管理 器 ， 还 提供 对 如 JMS 事 务 管理 的 管理 器 等 ，Spring 提 供 一 致 的 事 
务 抽象 如 图 9-1 所 示 。 


| 对 关系 数据 库 本 地 事务 支持 
提供 Spring JDBC 抽 象 框架 政 iBATIS 事 务 支持 


DataSourceTransactionManager 


事务 管理 器 抽象 


<< 扩 中 >> 


提供 集成 Hibernate 框 架 事 务 支持 


HibernateTransactionManager 











图 9-1 Spring 事 务 管理 器 
接 下 来 让 我 们 学 习 一 下 如 何在 Spring 配置 文件 中 定义 事务 管理 器 : 
声明 对 本 地 事务 的 支持 : 


A 


a)JDBC 及 iBATIS、MyBatis 框 架 事 务 管理 器 


<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionMana 
<property name="dataSource" ref="dataSource"/> 
</bean> 


司 一 一 


通过 dataSource 属 性 指定 需要 事务 管理 的 单个 javax.sql.DataSource 对 象 。 





b)Jdo 事 务 管理 器 


<bean id="txManager" class="org.springframework.orm.jdo.JdoTransactionManager"> 
<property name="persistenceManagerFactory" ref="persistenceManagerFactory"/> 
</bean> 


过 persistenceManagerFactory 属 性 指定 需要 事务 管理 的 
en 象 。 


C)Jpa 事 务 管理 器 


<bean id="txManager" class="org.springframework.orm.jpa.JpaTransactionManager"> 
<property name="entityManagerFactory" ref="entityManagerFactory"/> 
</bean> 
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通过 entityManagerFactory 属 性 指定 需要 事务 管理 的 javax.persistence.EntityManagerFactory 


对 象 。 


还 需要 为 entityManagerFactory 对 象 指 定 jpaDialect 属 性 ， 该 属性 所 对 应 的 对 象 指 定 了 如 何 获 
取 连 接 对 象 、 开 局 事 务 、 关 闭 事务 等 事务 管理 相关 的 行为 。 


<bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityMa 
<property name="jpaDialect" ref="jpaDialect"/> 

</bean> 

<bean id="jpaDialect" class="org.springframework.orm.jpa.vendor.HibernateJpaDialect"/> 
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d)Hibernate 事 务 管理 器 


<bean id="txManager" class="org.springframework.orm.hibernate3.HibernateTransactionManage 
<property name="sessionFactory" ref="sessionFactory"/> 
</bean> 
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通过 entityManagerFactory 属 性 指定 需要 事务 管理 的 org.hibernate.SessionFactory 对 象 。 
二 、Spring 对 全 局 事务 的 支持 : 


a)Jta 事 务 管理 器 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:jee="http://www.springframework.org/schema/jee" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/jee 
http://www.springframework.org/schema/jee/spring-jee-3.0.xsd"> 


<jee:jndi-lookup id="dataSource" jndi-name="jdbc/test"/> 
<bean id="txManager" class="org.springframework.transaction.jta.JtaTransactionManager"> 
<property name="transactionManagerName" value=" java:comp/TransactionManager"/> 
</bean> 
</beans> 


A 


“dataSource”Bean 表 示 从 JNDI 中 获取 的 数据 源 ， 而 txManager 是 JTA 事 务 管理 器 ， 其 中 属性 
transactionManagerName 指 定 了 JTA 事 务 管理 器 的 JNDI 名 字 ， 从 而 将 事务 管理 委托 给 该 事务 


管理 器 。 
这 只 是 最 简单 的 配置 方式 ， 更 复杂 的 形式 请 参考 Spring Javadoc。 


在 此 我 们 再 介绍 两 个 不 依赖 于 应 用 服务 器 的 开源 JTA 事 务实 现 : JOTM 和 Atomikos 
Transactions Essentials。 


。 JOTM : 即 基于 Java 开 放 事 务 管理 器 (Java Open Transaction Manager) ， 实 现 JTA 规 
范 ， 能 够 运行 在 非 应 用 服务 器 环境 中 ，Web 容 器 或 独立 Java SE 环境 ， 官 网 地 址 : 


http://jotm.objectweb.org/ ° 

。 Atomikos Transactions Essentials : 其 为 Atomikos 开 发 的 事务 管理 器 ， 该 产品 属于 开 
源 产品 ， 另 外 还 一 个 商业 的 Extreme Transactions。 官 网 地 址 为 : 
http://www.atomikos.com 。 


对 于 以 上 JTA 事 务 管理 器 使 用 ， 本 文 作 者 只 en ， 如 果 在 实际 项 目 中 需要 不 依赖 于 应 
用 服务 器 的 JTA 事 务 支 持 ， 需 详细 测试 并 选择 合适 的 。 


在 本 文中 将 使 用 Atomikos Transactions Essentials 来 进行 演示 JTA 事 务 使 用 ， 由 于 Atomikos 对 
hsqldb 分 布 式 支持 不 是 很 好 ， 在 Atomikos 官 网 中 列 出 如 下 兼容 的 数据 库 : Oracle、Informix、 
FirstSQL、DB2、MySQL、SQLServer、Sybase， 这 不 代表 其 他 数据 库 不 支持 ， 而 是 
Atomikos 团 队 没 完全 测试 ， 在 此 作者 决定 使 用 derby 内 存 数据 库 来 演示 JTA 分 布 式 事务 


1、 首 先 准 备 jar 包 
1.1、 准 备 derby 数 据 jar 包 ， 到 下 载 的 spring-framework-3.0.5.RELEASE-dependencies.zip 中 
拷贝 如 下 jar 包 

e。 com.springsource.org.apache.derby-10.5.1000001.764942.jar 


1. 2、 准备 Atomikos Transactions Essentials 对 JTA 事 务 支持 的 JTA 包 ， 此 处 使 用 
AtomikosTransactionsEssentials3.5.5 版 本 ， 到 官网 下 载 AtomikosTransactionsEssentials- 
3.5.5.zip， 拷 贝 如 下 jar 包 到 类 路 径 : 

。 atomikos-util.jar 

。 transactions-api.jar 

。 transactions-essentials-all.jar 

。 transactions-jdbc.jar 

。 transactions-jta.jar 

。 transactions.jar 


将 如 上 jar 包 放 在 libvatomikos 目 录 下 ， 并 添加 到 类 路 径 中 。 
2、 接 下 来 看 一 下 在 Spring 中 如 何 配置 AtomikosTransactionsEssentials JTA 事 务 : 


2.1、 配 置 分 布 式 数据 源 : 


<bean id="dataSource1" class="com.atomikos.jdbc.AtomikosDataSourceBean" init-method="init 
<property name="uniqueResourceName" value="jdbc/test1"/> 
<property name="xaDataSourceClassName" value="org.apache.derby.jdbc.EmbeddedXADataSou 
<property name="poolSize" value="5"/> 
<property name="xaProperties"> 
<props> 
<prop key="databaseName">test1</prop> 
<prop key="createDatabase">create</prop> 
</props> 
</property> 
</bean> 


<bean id="dataSource2" class="com.atomikos.jdbc.AtomikosDataSourceBean" 
init-method="init" destroy-method="close"> 


</bean> 
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在 此 我 们 配置 两 个 分 布 式 数据 源 : 使 用 com.atomikos.jdbc.AtomikosDataSourceBean 来 配置 
AtomikosTransactionsEssentials 分 布 式 数据 源 : 


。 UniqueResourceName 表 示 唯 一 资源 名 ， 如 有 多 个 数据 源 不 可 重复 ; 

。 xaDataSourceClassName 是 具体 分 布 式 数据 源 厂商 实现 ; 

e。 poolSize 是 数据 连接 池 大 小 ; 

。 XaProperties 属 性 指定 具体 厂商 数据 库 属 性 ， 如 databaseName 指 定数 据 库 名 ， 
createDatabase 表 示 启 动 derby 内 寿 数 据 库 时 创建 databaseName 指 定 的 数据 库 。 


在 此 我 们 还 有 定义 了 一 个 “dataSource2”"Bean， 其 属性 和 “DataSource1” 除 以 下 不 一 样 其 他 完 
全 一 样 : 


。 uniqueResourceName : 因为 不 能 重复 ， 因 此 此 处 使 用 jdbc/test2 ; 
。 databaseName : 我 们 需要 指定 两 个 数据 库 ， 因 此 此 处 我 们 指定 为 test2。 


2.2、 配 置 事务 管理 器 : 


<bean id="atomikosTransactionManager" class = "com.atomikos.icatch.jta.UserTransactionMan 
<property name="forceShutdown" value="true"/> 
</bean> 


<bean id="atomikosUserTransaction" class="com.atomikos.icatch.jta.UserTransactionImp"> < 


<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionMa 
<property name="transactionManager"> 
<ref bean="atomikosTransactionManager"/> 
</property> 
<property name="userTransaction"> 
<ref bean="atomikosUserTransaction"/> 
</property> 
</bean> 
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。 atomikosTransactionManager : 定义 了 AtomikosTransactionsEssentials 事 务 管理 器 ; 

。 atomikosUserTransaction : 定义 UserTransaction， 该 Bean 是 线程 安全 的 ; 

。 transactionManager : 定义 Spring 事务 管理 器 ，transactionManager 属 性 指定 外 部 事务 管 
理 器 ( 丨 正 的 事务 管理 者 ) ， 使 用 userTransaction 指 定 UserTransaction， 该 属性 一 般 用 


于 本 地 JTA 实 现 ， 如 果 使 用 应 用 服务 器 事务 管理 器 ， 该 属性 将 自动 从 JNDI 获 取 。 


配置 完毕 ， 是 不 是 也 挺 简单 的 ， 但 是 如 果 确 实 需要 使 用 JTA 事 务 ， 请 首先 选择 应 用 服务 器 事务 
管理 器 ， 本 示例 不 适合 生产 环境 ， 如 果 非 要 运用 到 生产 环境 ， 可 以 考虑 购买 
AtomikosTransactionsEssentials 商 业 支 持 。 


b) 特 定 服务 器 事务 管理 器 


Spring 还 提供 了 对 特定 应 用 服务 器 事务 管理 器 集成 的 支持 ， 目 前 提供 对 IBM WebSphere、 
BEA WebLogic、 Oracle OC4J 应 用 服务 器 高 级 事务 的 支持 ， 具 体 使 用 请 参考 Spring 
Javadoc。 


现在 我 们 已 经 学 习 如 何 配置 事务 管理 器 了 ， 但 是 只 有 事务 管理 器 Spring 能 自动 进行 事务 管理 
吗 ? 当然 不 能 了 ， 这 需要 我 们 来 控制 ， 目 前 Spring 支持 两 种 事务 管理 方式 : 编程 式 和 声明 式 事 
务 管理 。 接 下 来 先 看 一 下 如 何 进行 编程 式 事务 管理 吧 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2503.html] 


【第 九 章 】 Spring 的 事务 之 9.3 编程 式 事务 一 一 
跟 我 学 spring3 

9.3 编程 式 事务 

9.3.1 编程 式 事务 概述 


所 谓 编程 式 事务 指 的 是 通过 编码 方式 实现 事务 ， 即 类 似 于 JDBC 编 程 实现 事务 管理 。 


Spring 框架 提供 一 致 的 事务 抽象 ， 因 此 对 于 JDBC 还 是 JTA 事 务 都 是 采用 相同 的 API 进 行 编程 。 


Connection conn = null; 
UserTransaction tx = null; 


try { 
tx = getUserTransaction(); //1. 获 取 事 务 
tx.begin(); //2. 开 启 JTA 事 务 
conn = getDataSource().getconnection(); //3 .获取 JDBC 


//4. 声 明 SQL 
String sql = "select * from INFORMATION_SCHEMA.SYSTEM_TABLES"; 
PreparedStatement pstmt = conn.prepareStatement(sql);//5., 预 编译 SQL 


ResultSet rs = pstmt.executeQuery(); //6. 执 行 SQL 
process(rs); //7 .处 理 结果 集 
closeResultSet (rs); //8 .释放 结果 集 
tx.commit( ) ; //7 .提交 事务 

} catch (Exception e) { 
tx.rollback(); //8. 回 滚 事务 
throw e; 

} finally { 
conn.close( ); // 关 闭 连 接 


} 


此 处 可 以 看 到 使 用 UserTransaction 而 不 是 Connection 连 接 进 行 控制 事务 ， 从 而 对 于 JDBC 事 
务 和 JTA 事 务 是 采用 不 同 API| 进 行 编程 控制 的 ， 并 且 JTA 和 JDBC 事 务 管理 的 异常 也 是 不 一 样 
的 。 


具体 如 何 使 用 JTA 编 程 进行 事务 管理 请 参考 cn.javass.spring.chapter9 包 下 的 
TranditionalTransactionTest 类 。 


而 在 Spring 中 将 采用 一 致 的 事务 抽象 进行 控制 和 一 致 的 异常 控制 ， 即 面向 
PlatformTransactionManager 接 口 编程 来 控制 事务 

9.3.1 Spring 对 编程 式 事务 的 支持 
Spring 中 的 事务 分 为 物理 事务 和 逻辑 事务 ; 


。 物理 事务 : 就 是 底层 数据 库 提供 的 事务 支持 ， 如 JDBC 或 JTA 提 供 的 事务 ; 
。 逻辑 事务 : 是 Spring 管理 的 事务 ， 不 同 于 物理 事务 ， 逻 辑 事务 提供 更 丰富 的 控制 ， 而 且 如 
果 想 得 到 Spring 事务 管理 的 好 处 ， 必 须 使 用 逻辑 事务 ， 因 此 在 Spring 中 如 果 没 特别 强调 一 


般 就 是 逻辑 事务 ; 
逻辑 事务 即 支持 非常 低级 别 的 控制 ， 也 有 高 级 别 解决 方案 : 
e@ 低级 别 解决 方案 : 


: 使 用 工具 类 获取 连接 (会话 ) 和 释放 连接 (会话 ) ， 如 使 用 
org. ee jdbc.datasource 包 中 的 DataSourceUtils 类 来 获取 和 释放 具有 逻辑 事务 
功能 的 连接 。 当 然 对 集成 第 三 方 ORM 框 架 也 提供 了 类 似 的 工具 类 ， 如 对 Hibernate 提 供 了 
SessionFactoryUtils 工 具 类 ，JPA 的 EntityManagerFactoryUtils 等 ， 其 他 工具 类 都 是 使 用 类 
似 *Utils 命 名 ; 


// 获 取 具 有 Spring 事 务 (逻辑 事务 ) 管理 功能 的 连接 

DataSourceUtils. getConnection(DataSource dataSource) 

// 释 放 具 有 Spring 事务 〈 逮 辑 事务 ) 管理 功能 的 连接 

DataSourceUtils. releaseConnection(Connection con, DataSource dataSource) 


TransactionAwareDataSourceProxy : 使 用 该 数据 源 代理 类 包装 需要 Spring 事 务 管理 支持 的 
、 ， 该 包装 类 必须 位 于 最 外 层 ， 主 要 用 于 遗留 项 目 中 可 能 直接 使 用 数据 源 获 取 连 接 和 释 

连接 支持 或 希望 在 Spring 中 进行 混合 使 用 各 种 持久 化 框架 时 使 用 ， 其 内 部 实际 使 用 
DataSourceUtils 工具 类 获取 和 释放 申 正 连接 ; 


<1-- 使 用 该 方式 包装 数据 源 ， 必 须 在 最 外 层 ，targetDataSource 知道 目标 数据 源 - -> 
<bean id="dataSourceProxy" 
class="org.springframework.jdbc.datasource. 
TransactionAwareDataSourceProxy"> 

<property name="targetDataSource" ref="dataSource"/> 
</bean> 


通过 如 上 方式 包装 数据 源 后 ， 可 以 在 项 目 Ue me 的 方式 来 获得 逻辑 事务 的 支 
持 ， 即 支持 直接 从 DataSource 获 取 连 接 和 释放 连接 ， 且 这 些 连 接 自动 支持 Spring 逻辑 事务 ; 
。 高 级 别 解 决 方案 : 


模板 类 : 使 用 Spring 提供 的 模板 类 ， 如 JdbcTemplate、HibernateTemplate 和 JpaTemplate 模 
板 类 等 ， 而 这 些 模板 类 内 部 其 实 是 使 用 了 低级 别 解 决 方案 中 的 工具 类 来 管理 连接 或 会 话 ; 


Spring 提供 两 种 编程 式 事务 支持 : 直接 使 用 PlatformTransactionManager 实 现 和 使 用 
TransactionTemplate 模 板 类 ， 用 于 支持 逻辑 事务 管理 。 


如 果 采 用 编程 式 事务 推荐 使 用 TransactionTemplate 模 板 类 和 高 级 别 解决 方案 。 


9.3.3 使 用 PlatformTransactionManager 


首先 让 我 们 看 下 如 何 使 用 PlatformTransactionManager 实 现 来 进行 事务 管理 : 


1、 数 据 源 定义 ， 此 处 使 用 第 7 章 的 配置 文件 ， 即 “chapter7/ applicationContext- 
resources.xml” 文 件 。 


2、 事 务 管理 器 定义 (chapter9/applicationContext-jdbc.xml) 


<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransa 
<property name="dataSource" ref="dataSource"/> 
</bean> 
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3、 准备 测试 环境 : 








3.1、 首 先 准备 测试 时 使 用 的 SQL : 


package cn.javass.spring.chapter9; 
// 省 略 import 
public class TransactionTest { 
/Vid 自 增 主键 从 9 开始 
private static final String CREATE_TABLE_SQL = "create table test" + 
"(id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, " + 
"name varchar(100))"; 
private static final String DROP_TABLE SQL = "drop table test"; 
private static final String INSERT_ SQL = "insert into test(name) values(?)"; 
private static final String COUNT_SQL = "select count(*) from test"; 


忆 


3.2、 初 始 化 Spring 容器 


package cn.javass.spring.chapter9; 

// 省 略 import 

public class TransactionTest { 
private static ApplicationContext ctx; 
private static PlatformTransactionManager txManager; 
private static DataSource dataSource; 
private static JdbcTemplate jdbcTemplate,; 
@BeforeClass 
public static void setUpClass() { 

String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter9/applicationContext-jdbc.xml"}; 

ctx = new ClassPathxmlApplicationContext(configLocations); 

txManager = ctx.getBean(PlatformTransactionManager .class); 
dataSource = ctx.getBean(DataSource.class); 

jdbcTemplate = new JdbcTemplate(dataSource); 
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@Test 
public void testPplatformTransactionManager() { 
DefaultTransactionDefinition def = new DefaultTransactionDefinition(); 
def.setIsolationLevel(TransactionDefinition.ISOLATION_ READ COMMITTED); 
def.setPropagationBehavior(TransactionDefinition.PROPAGATION_ REQUIRED); 
TransactionStatus status = txManager.getTransaction(def); 
jdbcTemplate.execute(CREATE_TABLE_ SQL); 
try { 
jdbcTemplate.update(INSERT_SQL, "test"); 
txManager .commit(status); 
} catch (RuntimeException e) { 
txManager .rollback(status); 


} 
jdbcTemp1late.execute(DROP_TABLE_SQL ) ; 


。 DefaultTransactionDefinition : 事务 定义 ， 定 义 如 隔离 级 别 、 传 播 行 为 等 ， 即 在 本 示例 


中 隔离 级 别 为 ISOLATION_READ_COMMITTED (提交 读 ) ， 传 播 行为 为 


PROPAGATION_REQUIRED (必须 有 事务 支持 ， 即 如 果 当 前 没有 事务 ， 就 新 建 一 个 事 


务 ， 如 果 已 经 存在 一 个 事务 中 ， 就 加 入 到 这 个 事务 中 ) 。 


。 TransactionStatus : 事务 状态 类 ， 通 过 PlatformTransactionManager 的 getTransaction 


方法 根据 事务 定义 获取 ; 获取 事务 状态 后 ，Spring 根 据 传播 行为 来 决定 如 何 开 局 事务 ; 
。 JdbcTemplate : 通过 JdbcTemplate 对 象 执行 相应 的 SQL 操作 ， 且 自动 享受 到 事务 支持 ， 
注意 事务 是 线程 绑 定 的 ， 因 此 事务 管理 器 可 以 运行 在 多 线程 环境 ; 
。 txManager.commit(status) : 提交 status 对 象 绑 定 的 事务 ; 
。 txManagerrollback(status) : 当 遇 到 弄 常 时 回 滚 status 对 象 绑 定 的 事务 。 


3.4、 使 用 低级 别 解 决 方案 来 进行 事务 管理 器 测试 : 


@Test 
public void testPplatformTransactionManagerForLowLevel1() { 


DefaultTransactionDefinition def = new DefaultTransactionDefinition(); def.setIsolat 


TransactionStatus status = txManager .getTransaction(def); 
Connection conn = DataSourceUtils.getCconnection(dataSource); 
try { 
conn.prepareStatement(CREATE_TABLE_SQL) .execute( ) 
PreparedStatement pstmt = conn.prepareStatement(INSERT_ SQL); 
pstmt .setString(1， "test"); 
pstmt.execute( ) ; 
conn.prepareStatement(DROP_TABLE_SQL) .execute() ; 
txManager .commit(status); 
} catch (Exception e) { 
status.setRollbackonly(); 
txManager .rollback(status); 
} finally { 
DataSourceUtils.releaseConnection(conn, dataSource); 


} 
} 
es 





低级 别 方案 中 使 用 DataSourceUtils 获 取 和 释放 和 连接， 使 用 txManager 开 管理 事务 ， 而 且 面 向 


JDBC 编 程 ， 比 起 模板 类 方式 来 演 瑛 和 复杂 的 多 ， 因 此 不 推荐 使 用 该 方式 。 在 此 就 不 介绍 
源 代理 类 使 用 了 ， 需 要 请 参考 platformTransactionManagerForLowLevelTest2 测 试 方法 。 


到 此 事务 管理 是 不 是 还 很 繁琐 ? 必须 手工 提交 或 回 滚 事务 ， 有 没有 更 好 的 解决 方案 呢 ? Spring 
提供 了 TransactionTemplate 模 板 类 来 简化 事务 管理 。 


9.3.4 使 用 TransactionTemplate 


TransactionTemplate 模 板 类 用 于 简化 事务 管理 ， 事 务 管 理由 模板 类 定义 ， 而 具体 操作 需要 通 
过 TransactionCallback 回 调 接口 或 TransactionCallbackWithoutResult 回 调 接口 指定 ， 通 过 调 
用 模板 类 的 参数 类 型 为 TransactionCallback 或 TransactionCallbackWithoutResult 的 execute 方 
法 来 自动 享受 事务 管理 。 


TransactionTemplate 模 板 类 使 用 的 回调 接口 : 


。 TransactionCallback : 通过 实现 该 接口 的 “T dolnTransaction(TransactionStatus status) 
"方法 来 定义 需要 事务 管理 的 操作 代码 ; 

。 TransactionCallbackWithoutResult : 继承 TransactionCallback 接 口 ， 提 供 “void 
dolnTransactionWithoutResult(TransactionStatus status)" 便 利 接口 用 于 方便 那些 不 需要 
返回 值 的 事务 操作 代码 。 


1、 接 下 来 演示 一 下 TransactionTemplate 模 板 类 如 何 使 用 : 


@Test 
public void testTransactionTemplate() {// 位 于 TransactionTest 类 中 
jdbcTemplate.execute(CREATE_TABLE_SQL); 
TransactionTemplate transactionTemplate = new TransactionTemplate(txManager ); 
transactionTemplate.setIisolationLevel(TransactionDefinition.ISOLATION_ READ_COMMITTED); 
transactionTemplate.execute(new TransactionCallbackwithoutResult() { 
@Override 
protected void doInTransactionWithoutResult(TransactionStatus status) { 
jdbcTemplate.update(INSERT_ SQL, "test"); 
}}); 


jdbcTemplate.execute(DROP_TABLE_SQL ) ; 
| 


。 TransactionTemplate : 通过 new TransactionTemplate(txManager) 创 建 事 务 模板 类 ， 其 
中 构造 器 参数 为 PlatformTransactionManager 实 现 ， 并 通过 其 相应 方法 设置 事务 定义 ， 如 
事务 隔离 级 别 、 传 播 行为 等 ， 此 处 未 指定 传播 行为 ， 其 默认 为 
PROPAGATION_REQUIRED ; 

。 TransactionCallbackWithoutResult : 此 处 使 用 不 带 返回 的 回调 实现 ， 其 
dolnTransactionWithoutResult 方 法 实现 中 定义 了 需要 事务 管理 的 操作 ; 

。 transactionTemplate.execute() : 通过 该 方法 执行 需要 事务 管理 的 回调 。 


这 样 是 不 是 简单 多 了 ， 没 有 事务 管理 代码 ， 而 是 由 模板 类 来 完成 事务 管理 。 


注 : 对 于 抛 出 Exception 类 型 的 异常 且 需 要 回 滚 时 ， 需 要 捕获 异常 并 通过 调用 status 对 象 的 
setRollbackOnly() 方 法 告知 事务 管理 器 当前 事务 需要 回 滚 ， 如 下 所 示 : 


try { 

// 业 务 操 作 

} catch (Exception e) { // 可 使 用 具体 业务 异常 代替 
status.setRollbackonly(); 

} 


2、 前 边 已 经 演示 了 JDBC 事 务 管理 ， 接 下 来 演示 一 下 JTA 分 布 式 事务 管理 : 


@Test 
public void testJtaTransactionTemplate() { 
String[] configLocations = new String[] { 
"classpath:chapter9/applicationContext-jta-derby.xml"}; 

ctx = new ClassPathxXmlApplicationContext(configLocations); 
final PlatformTransactionManager jtaTXManager = ctx.getBean(PlatformTransactionManage 
final DataSource derbyDataSource1 = ctx.getBean("dataSourcei", DataSource.class); 
final DataSource derbyDataSource2 = ctx.getBean("dataSource2", DataSource.class); 
final JdbcTemplate jdbcTemplate1 = new JdbcTemplate(derbyDataSource1); 
final JdbcTemplate jdbcTemplate2 = new JdbcTemplate(derbyDataSource2); 
TransactionTemplate transactionTemplate = new TransactionTemplate(jtaTXManager ) ; 
transactionTemplate.setIsolationLevel(TransactionDefinition.ISOLATION_READ_ COMMITTED) 
jdbcTemplate1.update(CREATE_ TABLE_ SQL); 
int originalCount = jdbcTemplate1.queryForInt(COUNT_ SQL); 
try { 

transactionTemplate.execute(new TransactionCallbackwithoutResult() { 

@Override 
protected void doInTransactionwithoutResult(TransactionStatus status) { 
jdbcTemplatel1.update(INSERT_ SQL, "test"); 
// 因 为 数据 库 2 没 有 创建 数据 库 表 因此 会 回 滚 事 务 
jdbcTemplate2.update(INSERT_ SQL, "test"); 
}}); 

} catch (RuntimeException e) { 

int count = jdbcTemplatel1.queryForInt(COUNT_ SQL); 

Assert.assertEquals(originalCount, count); 


} 
jdbcTemplate1.update(DROP_TABLE_ SQL); 





。 配置 文件 : 使 用 此 前 定义 的 chapter9/applicationContext-jta-derby.xml ; 

。 jtaTXManager : JTA 事 务 管理 器 ; 

e。 derbyDataSource1 和 derbyDataSource2 : derby 数 据 源 1 和 derby 数 据 源 2 ; 

。jdbcTemplate1 和 jdbcTemplate2 : 分 别 使 用 derbyDataSource1 和 derbyDataSource2 构 
造 的 JDBC 模 板 类 ; 

。 transactionTemplate : 使 用 taTXManager 事 务 管理 器 的 事务 管理 模板 类 ， 其 隔离 级 别 
为 提交 读 ， 传 播 行为 默认 为 PROPAGATION_REQUIRED (必须 有 事务 支持 ， 即 如 果 当 
前 没有 事务 ， 就 新 建 一 个 事务 ， 如 果 已 经 存在 一 个 事务 中 ， 就 加 入 到 这 个 事务 中 ) ; 

。jdbcTemplate1.update(CREATE_TABLE_SQL) : 此 处 只 有 derbyDataSource1 所 代表 的 
数据 库 创建 了 "test" 表 ， 而 derbyDataSource2 所 代表 的 数据 库 没 有 此 表 ; 

。 TransactionCallbackWithoutResult : 在 此 接口 实现 中 定义 了 需要 事务 支持 的 操作 : 


jdbcTemplate1.update(INSERT_SQL, "test") : 表示 向 数据 库 1 中 的 test 表 中 插入 数据 ; 


jdbcTemplate2.update(INSERT_SQL, "test") : 表示 向 数据 库 2 中 的 test 表 中 插入 数据 ， 但 数 
据 库 2 没有 此 表 将 抛 出 异常 ， 且 JTA 分 布 式 事务 将 回 滚 ; 


。 Assert.assertEquals(originalCount, count) : 用 来 验证 事务 是 否 回 滚 ， 验 证 结果 返回 
为 true， 说 明 分 布 式 事务 回 滚 了 。 


到 此 我 们 已 经 会 使 用 PlatformTransactionManager 和 TransactionTemplate 进 行 简单 事务 处 理 
了 ， 那 如 何 应 用 到 实际 项 目 中 去 呢 ? 接 下 来 让 我 们 看 下 如 何在 实际 项 目 中 应 用 Spring 管理 事 


务 。 


接 下 来 看 一 下 如 何 将 Spring 管 理事 务 应 用 到 实际 项 目 中 ， 为 简化 演示 ， 此 处 只 定义 最 简单 的 模 
型 对 象 和 不 完整 的 Dao 层 接口 和 Service 层 接口 : 


1、 首先 定义 项 目 中 的 模型 对 象 ， 本 示例 使 用 用 户 模型 和 用 户 地 址 模型 : 


模型 对 象 一 般 放 在 项 目 中 的 model 包 里 。 


package cn.javass.spring.chapter9.model; 
public class USserModel { 

private int id; 

private String name; 

private AddressModel address; 

// 省 略 getter 和 Setter 


package cn.javass.spring.chapter9.model; 
public class AddressModel { 

private int id; 

private String province; 

private String city; 

privateString street; 

private int userId; 

// 省 略 getter 和 Setter 


2.1、 定 义 Dao 层 接口 : 


package cn.javass.spring.chapterg9.service; 
import cn.javass.spring.chapter9.model.UserModel; 
public interface IUserService { 

public void save(UserModel user); 

public int countAll(); 


package cn.javass.spring.chapter9.service,; 
import cn.javass.spring.chapter9.model.AddressModel; 
public interface IAddressService { 

public void save(AddressModel] address); 

public int countAll(); 


2.2、 定 义 Dao 层 实现 : 


package cn.javass.spring.chapter9.dao.jdbc; 
// 省 略 import， 注 意 mode1 要 引用 Chapter 包 里 的 
public class UserJdbcDaoImp1 extends NamedParameterJdbcDaoSupport implements IUserDao { 


private final String INSERT_SQL = "insert into user(name) values(:name)"; 
private final String COUNT_ALL_SQL = "select count(*) from user"; 
@Override 


public void save(UserModel user) { 
KeyHolder generatedkKeyHolder = new GeneratedKeyHolder(); 
SqlParameterSource paramSource = new BeanpPropertySqlParameterSource(user); 
getNamedParameterJdbcTemplate().update(INSERT_SQL, paramSource, generatedKeyHolde 
user.setIid(generatedKeyHolder .getkey().intValue()); 


Q@Override 
public int countAll() { 
return getJdbcTemplate().queryForIint(COUNT_ALL_ SQL); 





package cn.javass.spring.chapter9.dao.jdbc; 
// 省 略 import， 注 意 mode1 要 引用 Chapter 包 里 的 
public class AddressJdbcDaoImpJ extends NamedParameterJdbcDaoSupport implements IAddressD 


private final String INSERT_SQL = "insert into address(province, city, street, user_i 
private final String COUNT ALL_ SQL = "select count(*) from address"; 
Q@Override 


public void save(AddressModel address) { 
KeyHolder generatedKeyHolder = new GeneratedKeyHolder(); 
SqlParameterSource paramSource = new BeanpPropertySqlParameterSource(address); 
getNamedParameterJdbcTemplate().update(INSERT_ SQL, paramSource, generatedKeyHolde 
address.setId(generatedKeyHolder .getkey().intValue()); 


} 
Q@Override 
public int countAll() { 
return getJdbcTemplate().queryForInt(COUNT_ALL_ SQL); 
} 
} 





3.1、 定 义 Service 层 接口 ， 一 般 使 用 “|xxxService” 命 名 : 


package cn.javass.spring.chapterg9. service; 
import cn.javass.spring.chapter9.model.UserModel; 
public interface IUserService { 

public void save(UserModel user); 

public int countAll(); 


} 


package cn.javass.spring.chapterg9. service; 
import cn.javass.spring.chapter9.model.AddressModel; 
public interface IAddressService { 

public void save(AddressModel address); 

public int countAll(); 


3.2、 定 义 Service 层 实现 ， 一 般 使 用 “xxxServicelmpl” 或 “xxxService” 命 名 : 


package cn.javass.spring.chapter9.service.impl; 
// 省 略 import， 注 意 mode1 要 引用 Chapter 包 里 的 
public class AddressServiceImpl implements IAddressService { 
private IAddressDao addressDao; 
private PlatformTransactionManager txManager; 
public void setAddressDao(IAddressDao addressDao) { 
this.addressDao = addressDao; 


public void setTxManager(PlatformTransactionManager txManager) { 
this.txManager = txManager ; 


Q@override 
public void save(final AddressModel address) { 
TransactionTemplate transactionTemplate = TransactionTemplateUtils.getDefaultTran 
transactionTemplate.execute(new TransactionCallbackwithoutResult() { 
@Override 
protected void doInTransactionwWithoutResult(TransactionStatus status) { 
addressDao.save(address); 
} 


}); 
了 


Q@override 
public int countAll() { 
return addressDao.countAll( ); 





package cn.javass.spring.chapter9.service.impl; 

// 省 略 import， 注 意 mode1 要 引用 Chapter 包 里 的 

public class UserServiceImpl implements IUserService { 
private IUserDao userDao; 
private IAddressService addressService,; 
private PlatformTransactionManager txManager; 
public void setUserDao(IUserDao userDao) { 

this.userDao = userDao; 


public void setTxManager(PlatformTransactionManager txManager) { 
this.txManager = txManager; 


public void setAddressService(IAddressService addressService) { 
this.addressService = addressService,; 
} 


Q@Override 
public void save(final UserModel user) { 
TransactionTemplate transactionTemplate = 
TransactionTemplateUtils.getDefaultTransactionTemplate(txManager ); 
transactionTemplate.execute(new TransactionCallbackwithoutResult() { 
Q@override 
protected void doInTransactionwithoutResult(TransactionStatus status) { 
userDao.save(user); 
user .getAddress().setUserId(user .getId()); 
addressService.save(user.getAddress( )); 
} 
}); 
} 


Q@Override 


public int countAll() { 
return userDao.countAll(); 
} 


Service 实 现 中 需要 Spring 事务 管理 的 部 分 应 该 使 用 TransactionTemplate 模 板 类 来 包装 执行 。 


4、 定 义 TransactionTemplateUtils ， 用 于 简化 获取 TransactionTemplate 模 板 类 ， 工 具 类 一 
般 放 在 util 包 中 : 


package cn.javass.spring.chapter9.util; 
// 省 略 import 
public class TransactionTemplateUtils { 
public static TransactionTemplate getTransactionTemplate( 
PlatformTransactionManager txManager, 
int propagationBehavior, 
int isolationLevel) { 


TransactionTemplate transactionTemplate = new TransactionTemplate(txManager ); 
transactionTemplate.setPropagationBehavior(propagationBehavior); 
transactionTemplate.setIsolationLevel(isolationLevel); 

return transactionTemplate; 


} 


public static TransactionTemplate getDefaultTransactionTemplate(PlatformTransactionMa 
return getTransactionTemplate( 
txManager ， 
TransactionDefinition.PROPAGATION_REQUIRED, 
TransactionDefinition.ISOLATION_READ_COMMITTED); 





getDefaultTransactionTemplate 用 于 获取 传播 行为 为 PROPAGATION_REQUIRED ， 隔离 级 别 
为 ISOLATION_READ_COMMITTED 的 模板 类 。 


5、 数 据 源 配置 定义 ， 此 处 使 用 第 7 章 的 配置 文件 ， 即 “chapter7/ applicationContext- 
resources.xml” 文 件 。 


6、Dao 层 配置 定义 (chapter9/dao/applicationContext-jdbc.xml) 


<bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionMana 
<property name="dataSource" ref="dataSource"/> 

</bean> 

<bean id="abstractDao" abstract="true"> 
<property name="dataSource" ref="dataSource"/> 

</bean> 


人 IE 





<bean id="userDao" class="cn.javass.spring.chapter9.dao.jdbc.UserJdbcDaoImpl" parent="abs 
<bean id="addressDao" class="cn.javass.spring.chapterg9.dao.jdbc.AddressJdbcDaoImpl" paren 


ME 





7、Service 层 配置 定义 (chapter9/service/applicationContext-service.xm|l) 


<bean id="userService" class="cn.javass.spring.chapter9.service.impl.UserServiceImpl"> 


<property name="userDao" ref="userDao"/> 
<property name="txManager" ref="txManager"/> 
<property name="addressService" ref="addressService"/> 


</bean> 
<bean id="addressService" class="cn.]javass.spring.chapterg9.service.impl.AddressServiceImp 


<property name="addressDao" ref="addressDao"/> 
<property name="txManager" ref="txManager"/> 


</bean> 


加 








8、 准 备 测试 需要 的 表 创 建 语句 ， 在 TransactionTest 测 试 类 中 添加 如 下 静态 交 量 : 


private static final String CREATE_USER_TABLE_SQL = 


"create table user" + 
"(id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY, " + 
"name varchar(100))"; 


private static final String DROP_USER_ TABLE SQL = "drop table user"; 


private static final String CREATE_ADDRESS_TABLE_SQL = 


"create table address" + 
"(id int GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY， " + 
"province varchar(100), city varchar(100), street varchar(100), user_id int)"; 


private static final String DROP_ADDRESS_ TABLE SQL = "drop table address"; 


9、 测 试 一 下 吧 : 


@Test 


} 


public void testServiceTransaction() { 
String[] configLocations = new String[] { 
"classpath:chapter7/applicationContext-resources.xml", 
"classpath:chapter9/dao/applicationContext-jdbc.xml", 
"classpath:chapter9/service/applicationContext-service.xml"}; 
ApplicationContext ctx2 = new ClassPathxmlApplicationContext(configLocations); 


DataSource dataSource2 = ctx2.getBean(DataSource.class); 
JdbcTemplate jdbcTemplate2 = new JdbcTemplate(dataSource2); 
jdbcTemplate2.update(CREATE_ USER_ TABLE_ SQL); 
jdbcTemplate2.update(CREATE ADDRESS_ TABLE_ SQL ) ; 


IUserService userService = ctx2.getBean("userService", IUserService.class); 
IAddressService addressService = ctx2.getBean("addressService", IAddressService.c 
UserModel user = createDefaultUserModel(); 

userService.save(user); 

Assert.assertEquals(1, userService.countAll()); 

Assert.assertEquals(1, addressService.countAll()); 
jdbcTemplate2.update(DROP_USER_ TABLE_ SQL); 
jdbcTemplate2.update(DROP_ADDRESS_ TABLE_SQL ) ; 


private UserModel createDefaultUserModel() { 


UserModel user = new UserModel(); 
user.setName("test"); 

AddressModel address = new AddressModel(); 
address.setProvince("beijing"); 
address.setCity("beijing"); 
address.setStreet("haidian"); 
user.setAddress(address); 

return user; 











从 Spring 容器 中 获取 Service 层 对 象 ， 调 用 Service 层 对 象 持 久 化 对 象 ， 大 家 有 没有 注意 到 
Spring 事务 全 部 在 Service 层 定义 ， 为 什么 会 在 Service 层 定义 ， 而 不 是 Dao 层 定义 呢 ? 这 是 因 
为 在 服务 层 可 能 牵扯 到 业务 逻辑 ， 而 每 个 业务 逻辑 可 能 调用 多 个 Dao 层 方法 ， 为 保证 这 些 操作 
的 原子 性 ， 必 须 在 Service 层 定义 事务 。 


还 有 大 家 有 没有 注意 到 如 果 Service 层 的 事务 管理 相当 令 人 头疼 ， 而 且 是 侵入 式 的 ， 有 没有 办 
法 消除 这 些 完 长 的 事务 管理 代码 呢 ? 这 就 需要 Spring 声 明 式 事务 支持 ， 下 一 节 将 介绍 无 侵入 式 
的 声明 式 事务 。 


可 能 大 家 对 事务 定义 中 的 各 种 属性 有 点 困惑 ， 如 传播 行为 到 底 干 什么 用 的 ? 接 下 来 将 详细 讲 
解 一 下 事务 属性 。 


9.3.5 事务 属性 


事务 属性 通过 TransactionDefinition 接 口 实现 定义 ， 主 要 有 事务 隔离 级 别 、 事 务 传播 行为 、 事 
务 超时 时 间 、 事 务 是 否 只 读 。 
Spring 提 供 TransactionDefinition 接 口 默 认 实 现 DefaultTransactionDefinition， 可 以 通过 该 实现 
类 指定 这 些 事务 属性 。 

。 事务 隔离 级 别 : 用 来 解决 并 发 事务 时 出 现 的 问题 ， 其 使 用 TransactionDefinition 中 的 静态 

变量 来 指定 : 

ISOLATION_DEFAULT : 默认 隔离 级 别 ， 即 使 用 底层 数据 库 默 认 的 隔离 级 别 ; 
ISOLATION_READ_UNCOMMITTED : 未 提交 读 ; 
ISOLATION_READ_COMMITTED : 提交 读 ， 一 般 情况 下 我 们 使 用 这 个 ; 
ISOLATION_REPEATABLE_READ : 可 重复 读 ; 
ISOLATION_SERIALIZABLE : 序列 化 。 


可 以 使 用 DefaultTransactionDefinition 类 的 setlsolationLevel(TransactionDefinition. 
ISOLATION_READ_COMMITTED) 来 指定 隔离 级 别 ， 其 中 此 处 表示 隔离 级 别 为 提交 读 ， 也 可 
以 使 用 或 setlsolationLevelName(“ISOLATION_READ _COMMITTED”) 方 式 指 定 ， 其 中 参数 就 
是 隔离 级 别 静 态 变量 的 名 字 ， 但 不 推荐 这 种 方式 。 


。 事务 传播 行为 : Spring 管 理 的 事务 是 逻辑 事务 ， 而 且 物 理事 务 和 人 辑 事 务 最 大 差别 就 在 于 
事务 传播 行为 ， 事 务 传播 行为 用 于 指定 在 多 个 事务 方法 间 调 用 时 ， 事 务 是 如 何在 这 些 方 
法 间 传 播 的 ，Spring 共 支持 7 种 传播 行为 : 
Required : 必须 有 逻辑 事务 ， 否 则 新 建 一 个 事务 ， 使 用 PROPAGATION_REQUIRED 指 定 ， 


表示 如 果 当 前 存在 一 个 逻辑 事务 ， 则 加 入 该 逻辑 事务 ， 否 则 将 新 建 一 个 逻辑 事务 ， 如 图 9-2 和 
9-3 上 所 示 ; 


serviceTransactionTest 0) 














全 二 已 开 忆 芝 天 多 由 芷 


信 捕 和 条 Regiredl 
2 调用 
UserSevice.savel() addressService.savel() 














图 9-3 Required 传 播 行为 抛 出 异常 情况 
在 前 边 示 例 中 就 是 使 用 的 Required 传 播 行为 : 


一 、 在 调用 userService 对 象 的 Save 方法 时 ， 此 方法 用 的 是 Required 传 播 行为 且 此 时 Spring 事 
务 管理 器 发 现 还 没 开启 逻辑 事务 ， 因 此 Spring 管理 器 觉得 开局 逻辑 事务 ， 


二 、 在 此 逻辑 事务 中 调用 了 addressService 对 象 的 Save 方 法， 而 在 save 方法 中 发 现 同样 用 的 
是 Required 传 播 行为 ， 因 此 使 用 该 已 经 存在 的 逻辑 事务 ; 


三 、 在 返回 到 addressService 对 象 的 Save 方 法 ， 当 事务 模板 类 执行 完毕 ， 此 时 提交 并 关闭 事 
务 。 

因此 UserService 对 象 的 save 方 法 和 addressService 的 save 方 法 属于 同一 个 物理 事务 ， 如 果 发 
生 回 滚 ， 则 两 者 都 回 滚 。 

接 下 来 测试 一 下 该 传播 行为 如 何 执行 吧 : 

a 正确 提交 测试 9 如 上 一 节 的 测试 在 此 不 再 演示 


二 、 回 滚 测试 ， 修 改 AddressServicelmpl 的 save 方 法 片段 : 


addressDao.save(address); 


为 


addressDao.save(address); 
// 抛 出 异常 ， 将 标识 当前 事务 需要 回 滚 
throw new RuntimeException(); 


二 、 修 改 UserServicelmpl 的 save 方 法 片段 : 


addressService.save(user.getAddress()); 


为 


try { 
addressService.save(user.getAddress());// 将 在 同一 个 事务 内 执行 
} catch (RuntimeException e) { 


} 


如 果 该 业务 方法 执行 时 事务 被 标记 为 回 滚 ， 则 不 管 在 此 是 否 捕获 该 异常 都 将 发 生 回 滚 ， 因 为 
处 于 同一 逮 辑 事务 。 


三 、 修 改 测试 方法 片段 : 


userService,.save(user); 
Assert.assertEquals(1, userService.countAll()); 
Assert.assertEquals(1, addressService.countAll()); 


为 如 下 形式 : 


try { 
userService.save(user); 
Assert.fail(); 

} catch (RuntimeException e) { 


} 
Assert.assertEquals(0, userService.countAll()); 
Assert.assertEquals(0, addressService.countAll()); 


Assert 断 言 中 countAll 方 法 都 返回 0， 说 明 事务 回 滚 了 ， 即 说 明 两 个 业务 方法 属于 同一 个 物理 
事务 ， 即 使 在 UserService 对 象 的 save 方法 中 将 异常 捕获 ， 由 于 addressService 对 象 的 Save 方 
法 抛 出 异常 ， 即 事务 管理 器 将 自动 标识 当前 事务 为 需要 回 滚 。 


RequiresNew : 创建 新 的 逻辑 事务 ， 使 用 PROPAGATION_REQUIRES_NEW 指 定 ， 表 示 每 
次 都 创建 新 的 逻辑 事务 (物理 事务 也 是 不 同 的 ) 如 图 9-4 和 9-5 所 示 : 
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图 9-4 RequiresNew 传 播 行为 
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图 9-5 RequiresNew 传 播 行为 并 抛 出 异常 
接 下 来 测试 一 个 该 传播 行为 如 何 执行 吧 : 


1、 将 如 下 获取 事务 模板 方式 


TransactionTemplate transactionTemplate = TransactionTemplateUtils.getDefaultTransactionT 


| 


替换 为 如 下 形式 ， 表 示 传 播 行为 为 RequiresNew : 





TransactionTemplate transactionTemplate = TransactionTemplateUtils.getTransactionTemplate 


txManager, 
TransactionDefinition.PROPAGATION_ REQUIRES_NEW, 
TransactionDefinition.ISOLATION READ COMMITTED); 


二 "| 


2、 执 行 如 下 测试 ， 发 现 执 行 结果 是 正确 的 : 


userService,.save(user); 
Assert.assertEquals(1, userService.countAll()); 
Assert.assertEquals(1, addressService.countAll()); 


3、 修 改 UserServicelmpl 的 save 方 法 片段 


userDao.save(user); 
user .getAddress().setUserId(user.getId()); 
addressService.save(user.getAddress( )); 


为 如 下 形式 ， 表 示 userServicelmpl 类 的 save 方 法 将 发 生 回 滚 ， 而 AddressServicelmpl 类 的 方 
法 由 于 在 抛 出 异常 前 执行 ， 将 成 功 提交 事务 到 数据 库 : 


userDao.save(user); 

user .getAddress().setUserId(user.getId()); 
addressService.save(user.getAddress()); 
throw new RuntimeException(); 


4、 修 改 测试 方法 片段 : 


userService.save(user); 
Assert.assertEquals(1, userService.countAll()); 
Assert.assertEquals(1, addressService.countAll()); 


为 如 下 形式 : 


try { 
userService.save(user); 
Assert.fail(); 

} catch (RuntimeException e) { 


} 
Assert.assertEquals(0, userService.countAll()); 
Assert.assertEquals(1, addressService.countAll()); 


Assert 断 言 中 调用 userService 对 象 countAI| 方 法 返回 0， 说 明 该 逻辑 事务 作用 域 回 滚 ， 而 调用 
addressService 对 象 的 countAII 方 法 返回 1， 说 明 该 逻辑 事务 作用 域 正 确 提交 。 因 此 这 是 不 正 
确 的 行为 ， 因 为 用 户 和 地 址 应 该 是 一 一 对 应 的 ， 不 应 该 发 生 这 种 情况 ， 因 此 此 处 正确 的 传播 
行为 应 该 是 Required 。 


该 传播 行为 执行 流程 (正确 提交 情况 ) 


一 、 当 执行 UserService 对 象 的 Save 方 法 时 ， 由 于 传播 行为 是 RequiresNew， 因 此 创建 一 个 新 
的 逻辑 事务 (物理 事务 也 是 不 同 的 ) ，; 

二 、 当 执行 到 addressService 对 象 的 save 方 法 时 ， 由 于 传播 行为 是 RequiresNew， 因 此 首先 
暂停 上 一 个 逻辑 事务 并 创建 一 个 新 的 逻辑 事务 (物理 事务 也 是 不 同 的 ); 


三 、addressService 对 象 的 save 方 法 执行 完毕 后 ， 提 交 逻 辑 事务 (并 提交 物理 事务 ) 并 重新 
恢复 上 一 个 逻辑 事务 ， 继 续 执 行 userService 对 象 的 save 方 法 内 的 操作 ; 


四 、 最 后 userService 对 象 的 save 方法 执行 完毕 ， 提 交 逻 辑 事务 (并 提交 物理 事务 ) 


五 、UserService 对 象 的 save 方 法 和 addressService 对 象 的 Save 方法 不 属于 同一 个 逻辑 事务 且 
也 不 属于 同一 个 物理 事务 。 


Supports : 支持 当前 事务 ， 使 用 PROPAGATION_SUPPORTS 指 定 ， 指 如 果 当 前 存在 逻辑 事 
务 ， 就 加 入 到 该 逻辑 事务 ， 如 果 当 前 没有 逻辑 事务 ， 就 以 非 事务 方式 执行 ， 如 图 9-6 和 9-7 所 


示 
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图 9-6 Required+Supports 传 播 行为 
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图 9-7 Supports+Supports 传 播 行为 


NotSupported : 不 支持 事务 ， 如 果 当 前 存在 事务 则 暂停 该 事务 ， 使 用 
PROPAGATION_NOT_SUPPORTED 指 定 ， 即 以 非 事务 方式 执行 ， 如 果 当 前 存在 逻辑 事务 ， 
就 把 当前 事务 暂停 ， 以 非 事务 方式 执行 ， 如 图 9-8 和 9-9 所 示 : 
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图 9-9 Supports+NotSupported 传 播 行为 


Mandatory : 必须 有 事务 ， 否 则 抛 出 异常 ， 使 用 PROPAGATION_MANDATORY 指 定 ， 使 用 
当前 事务 执行 ， 如 果 当 前 没有 事务 ， 则 抛 出 异常 〈l 川 egalTransactionStateException ) ， 如 图 
9-10 和 9-11 所 示 : 
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开局 新 事务) 用 已 开局 的 各 芝 








传播 行为 : Required | 传播 行 允 Nhndatory | 


UserSelvice.savel() 一 addressService.save() 


图 9-10 Required+Mandatory 传 播 行为 
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图 9-11 Supports+Mandatory 传 播 行为 



















Never : 不 支持 事务 ， 如 果 当 前 存在 是 事务 则 抛 出 异常 ， 使 用 PROPAGATION_NEVER 指 
定 ， 即 以 非 事务 方式 执行 ， 如 果 当 前 存在 事务 ， 则 抛 出 异常 
(lllegalTransactionStateException) ， 如 图 9-12 和 9-13 所 示 : 


serviceTransactionTest 0 
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图 9-12 Required+Never 传 播 行 为 
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图 9-13 Supports+Never 传 播 行为 


Nested : 嵌 套 事务 支持 ， 使 用 PROPAGATION_NESTED 指 定 ， 如 果 当 前 存在 事务 ， 则 在 诅 
套 事务 内 执行 ， 如 果 当 前 不 存在 事务 ， 则 创建 一 个 新 的 事务 ， 谋 套 事务 使 用 数据 库 中 的 保存 
点 来 实现 ， 即 说 套 事务 回 滚 不 影响 外 部 事务 ， 但 外 部 事务 回 滚 将 导致 谨 套 事务 回 滚 ， 如 图 9- 
14 和 9-15 所 示 : 
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图 9-15 Nested+Nested 传 播 行为 
Nested 和 RequiresNew 的 区 别 : 
1、RequiresNew 每 次 都 创建 新 的 独立 的 物理 事务 ， 而 Nested 只 有 一 个 物理 事务 ; 
2、Nested 嵌 套 事务 回 滚 或 提交 不 会 导致 外 部 事务 回 滚 或 提交 ， 但 外 部 事务 回 滚 将 导致 谋 套 
事务 回 滚 ， 而 RequiresNew 由 于 都 是 全 新 的 事务 ， 所 以 之 间 是 无 关联 的 ; 

3、 Nested 使 用 JDBC 3 的 保存 点 实现 ， 即 如 果 使 用 低 版 本 驱动 将 导致 不 支持 齿 套 事务 。 
使 用 瞬 套 事务 ， 必 须 确保 具体 事务 管理 器 实现 的 nestedTransactionAllowed 属 性 为 true， 否 则 


不 支持 谋 套 事务 ， 如 DataSourceTransactionManager 默 认 支 持 ， 而 
HibernateTransactionManager 默 认 不 支持 ， 需 要 我 们 来 开启 。 


对 于 事务 传播 行为 我 们 只 演示 了 Required 和 RequiresNew， 其 他 传播 行为 类 似 ， 如 果 对 这 些 
事务 传播 行为 不 太 会 使 用 ， 请 参考 chapter9 包 下 的 TransactionTest 测 试 类 中 的 testPropagation 
方法 ， 方 法 内 有 详细 示例 。 

e 事务 超时 : 设置 事务 的 超时 时 间 ， 单 位 为 秒 ， 默 认为 -1 表示 使 用 底层 事务 的 超时 时 间 ; 


使 用 如 setTimeout(100) 来 设置 超时 时 间 ， 如 果 事 务 超时 将 抛 出 
org.springframework.transaction.TransactionTimedOutException 异 常 并 将 当前 事务 标记 为 应 
该 回 滚 ， 即 超时 后 事务 被 自动 回 滚 ; 

可 以 使 用 具体 事务 管理 器 实现 的 defaultTimeout 属 性 设置 默认 的 事务 超时 时 间 ， 如 
DataSourceTransactionManager. setDefaultTimeout(10)° 


e@ 事务 只 读 : 将 事务 标识 为 只 读 ， 只 读 事务 不 修改 任何 数据 ; 
对 于 JDBC 只 是 简单 的 将 连接 设置 为 只 读 模式 ， 对 于 更 新 将 抛 出 异常 ; 


而 对 于 一 些 其 他 ORM 框 架 有 一 些 优化 作用 ， 如 在 Hibernate 中 ，Spring 事 务 管理 器 将 执 
行 "session.setFlushMode(FlushMode.MANUAL)" 即 指定 Hibernate 会 话 在 只 读 事务 模式 下 不 
尝试 检测 和 同步 持久 对 象 的 状态 的 更 新 。 


如 果 使 用 设置 具体 事务 管理 的 validateExistingTransaction 属 性 为 true (默认 false) ， 将 确保 
整个 事务 传播 链 都 是 只 读 或 都 不 是 只 读 ， 如 图 9-16 是 正确 的 事务 只 读 设置 ， 而 图 9-17 是 错误 
的 事务 只 读 设 置 : 
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图 9-16 正确 的 事务 只 读 设 置 
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图 9-17 错误 的 事务 只 读 设置 


如 图 10-17， 对 于 错误 的 事务 只 读 设置 将 抛 出 lllegalTransactionStateException 异 常 ， 并 伴 
随 “Participating transaction with definition [......] is not marked as read-only...... "信息 ， 表 示 
参与 的 事务 只 读 属 性 设置 错误 。 


大 家 有 没有 感觉 到 编程 式 实现 事务 管理 是 不 是 很 繁琐 宛 长 ， 重 复 ， 而 且 是 侵入 式 的 ， 因 此 发 
展 到 这 Spring 决定 使 用 配置 方式 实现 事务 管理 。 


9.3.6 配置 方式 实现 事务 管理 


在 Spring2.x 之 前 为 了 解决 编程 式 事务 管理 的 各 种 不 好 问题 ，Spring 提 出 使 用 配置 方式 实现 事 
务 管理 ， 配 置 方式 利用 代理 机 制 实现 ， 即 使 有 TransactionProxyFactoryBean 类 来 为 目标 类 代 
理事 务 管理 。 


接 下 来 演示 一 下 具体 使 用 吧 : 


1、 重 新 定义 业务 类 实现 ， 在 业务 类 中 无 需 显示 的 事务 管理 代码 : 


package cn.javass.spring.chapter9.service.impl; 
// 省 略 import 
public class ConfigAddressServiceImp1 implements IAddressService { 
private IAddressDao addressDao; 
public void setAddressDao(IAddressDao addressDao) { 
this.addressDao = addressDao; 


Q@Override 
public void save(final AddressModel address) { 
addressDao.save(address); 


了 
//countAll 方 法 实现 不 变 


package cn.javass.spring.chapter9.service.impl; 
// 省 略 import 
public class ConfigUserServiceImpl implements IUserService { 
private IUserDao userDao; 
private IAddressService addressService; 
public void setUserDao(IUserDao userDao) { 
this.userDao = userDao; 


public void setAddressService(IAddressService addressService) { 
this.addressService = addressService,; 


Q@Override 

public void save(final UserModel] user) { 
userDao.save(user); 
user .getAddress().setUserId(user .getId()); 
addressService.save(user.getAddress()); 


了 
/V/countA11 方 法 实现 不 变 


从 以 上 业务 类 中 可 以 看 出 ， 没 有 事务 管理 的 代码 ， 即 没有 侵入 式 的 代码 。 
2、 在 chapter9/service/applicationContext-service.xml 配 置 文件 中 添加 如 下 配置 : 


2.1、 首 先 添加 目标 类 定义 : 


<bean id="targetUserService" class="cn.]javass.spring.chapter9.service.impl.ConfigUserSeryv 
<property name="userDao" ref="userDao"/> 
<property name="addressService" ref="targetAddressService"/> 

</bean> 

<bean id="targetAddressService" class="cn.javass.spring.chapterg9.service.impl.ConfigAddre 
<property name="addressDao" ref="addressDao"/> 

</bean> 


Eee 





2.2、 配 置 TransactionProxyFactoryBean 类 : 


<bean id="transactionProxyParent" class="org.springframework.transaction.interceptor.Tran 
<property name="transactionManager" ref="txManager"/> 
<property name="transactionAttributes"> 
<props> 
<prop key="save*"> 
PROPAGATION_REQUIRED, 
ISOLATION_ READ_ COMMITTED, 
timeout_10, 
-Exception, 
+NoRollBackException 
</prop> 
<prop key="*"> 
PROPAGATION_REQUIRED, 
ISOLATION_ READ_ COMMITTED, 
readonly 
</prop> 
</props> 
</property> 
</bean> 


“| EE 








。 TransactionProxyFactoryBean : 用 于 为 目标 业务 类 创建 代理 的 Bean ; 
。 abstract="true" : 表示 该 Bean 是 抽象 的 ， 用 于 去 除 重复 配置 ; 


。 transactionManager : 事务 管理 器 定义 ; 

。 transactionAttributes : 表示 事务 属性 定义 : 

e。 PROPAGATION_REQUIRED,ISOLATION_READ_COMMITTED,timeout 10,- 
Exception,+NoRollBackException : 事务 属性 定义 ，Required 传 播 行 为 ， 提 交 读 隔离 
级 别 ， 事 务 超时 时 间 为 10 秒 ， 将 对 所 有 Exception 弄 常 回 滚 ， 而 对 于 抛 出 
NoRollBackException 异 常 将 不 发 生 回 滚 而 是 提交 ; 


。 PROPAGATION_REQUIRED,ISOLATION_READ_COMMITTED,readOnly : 事务 属性 


定义 ，Required 传 播 行为 ， 提 交 读 隔离 级 别 ， 事 务 是 只 读 的 ， 且 只 对 默认 的 
RuntimeException 异 常 回 滚 ; 


。 <prop key="save*"> : 表示 将 代理 以 save 开 头 的 方法 ， 即 当 执 行 到 该 方法 时 会 为 该 方法 


根据 事务 属性 配置 来 开启 /关闭 事务 ; 
。 <prop key='"*"> : 表示 将 代理 其 他 所 有 方法 ， 但 需要 注意 代理 方式 ， 默 认 是 JDK 代 理 ， 
只 有 public 方 法 能 代理 ; 


注 : 事务 属性 的 传播 行为 和 隔离 级 别 使 用 TransactionDefinition 静 态 变 量 名 指定 ; 事务 超时 使 


用 “timeout 超时 时 间 ? 指 定 ， 事 务 只 读 使 用 eadOnly" 指 定 ， 需 要 回 滚 的 异常 使 用 “异常 指 
定 ， 不 需要 回 滚 的 异常 使 用 "+ 异常 指定， 默认 只 对 RuntimeException 姬 常 回 滚 。 


需要 特别 注意 "- 异 常 "和 "+ 异常 "中 并 常 "只 是 时 实 异常 的 部 分 名 ， 内 部 使 用 如 下 方式 判断 


// 真 实 抛 出 的 异常 .name.indexOf( 配 置 中 指定 的 需要 回 滚 /不 回 滚 的 异常 名 ) 
exceptionClass.getName().indexOof(this.exceptionName) 


因此 异常 定义 时 需要 特别 注意 ， 配 置 中 定义 的 异常 只 是 夏 实 异常 的 部 分 名 。 
2.3、 定 义 代 理 Bean : 


<bean Id="proxyUserService"”parent='"transactionProxyParent"> 
<property name="target" ref="targetUserService"/> 

</bean> 

<bean id="proxyAddressService" parent="transactionproxyParent"> 
<property name="target" ref="targetAddressService"/> 

</bean> 


代理 Bean 通 过 集成 抽象 Bean“transactionProxyParent”， 并 通过 target 届 性 设置 目标 Bean， 在 


实际 使 用 中 应 该 使 用 该 代理 Bean 。 
3、 修 改 测试 方法 并 测试 该 配置 方式 是 否 好 用 : 


将 TransactionTest 类 的 testServiceTransaction 测 试 方法 拷贝 一 份 命名 为 
testConfigTransaction : 


并 在 testConfigTransaction 测 试 方法 内 将 : 


IUserService userService = 

ctx2.getBean("userService", IUserService.class); 
IAddressService addressService = 
ctx2.getBean("addressService", IAddressService.class); 


替换 为 : 


IUserService userService = 

ctx2.getBean("proxyUserService ", IUserService.class); 
IAddressService addressService = 
ctx2.getBean("proxyAddressService ", IAddressService.class); 


4、 执 行 测试 ， 测 试 正 常 通过 ， 说 明 该 方式 能 正常 工作 ， 当 调用 save 方 法 时 将 匹配 到 “<prop 
key="save*">” 定 义 ， 而 countAll 将 匹配 到 “<prop key="save*">” 定 义 ， 底 层 代 理会 应 用 相应 
定义 中 的 事务 属性 来 创建 或 关闭 事务 。 
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.内 部 实现 


1、 使 用 已 开启 事务 
2、 委 托 实 现 
3、 无 需 关闭 事务 直接 返回 









1、 开 启事 务 
2、 委 托 实 现 
3、 提交 并 关闭 事务 




















argetlserService save() 


图 9-18 代理 方式 实现 事务 管理 


argetAddressServicesave() 





如 图 9-18， 代 理 方式 实现 事务 管理 只 是 将 硬 编码 的 事务 管理 代码 转移 到 代理 中 去 由 代理 实 
现 ， 在 代理 中 实现 事务 管理 


0° 


注 : 在 代理 模式 下 ， 默 认 只 有 通过 代理 对 象 调用 的 方法 才能 应 用 相应 的 事务 属性 ， 而 在 目标 
方法 内 的 “自我 调用 ”是 不 会 应 用 相应 的 事务 属性 的 ， 即 被 调用 方法 不 会 应 用 相应 的 事务 属 
性 ， 而 是 使 用 调用 方法 的 事务 属性 。 

如 图 9-19 所 示 ， 在 目标 对 象 targetUserService 的 save 方 法 内 调用 事务 方 


法 “this.otherTransactionMethod()" 将 不 会 应 用 配置 的 传播 行为 RequriesNew， 开 局 新 事务 ， 
而 是 使 用 save 方 法 的 已 开启 事务 ， 如 果 非 要 这 样 使 用 如 下 方式 实现 : 


1、 修 改 TransactionProxyFactoryBean 配 置 定义 ， 添 加 exposeProxy 属 性 为 true ; 


2、 在 业务 方法 内 通过 代理 对 象 调 用 相应 的 事务 方 放 ， 如 
“((IUserService)AopContext.currentProxy()).otherTransactionMethod()" 即 可 应 用 配置 的 
事务 属性 。 


3 、 使 用 这 种 方式 属于 侵入 式 ， 不 推荐 使 用 ， 除 非 必要 。 


ConfigTransactionTest © 












1、 开 启事 务 
2、 委 托 实现 
3、 提 到 并 关闭 事务 


















proxyUserService savel() 















内 部 调用 


自我 调用 不 会 应 用 传播 行为 | 传播 行 允 RequiresNew | 
RequiresNews 而 是 使 用 mve 方 法 的 
Requir ed 传播 行为 ， 即 使 有 save 的 已 开启 | 
看 务 


























图 9-19 代理 方式 下 的 自我 调用 


配置 方式 也 好 麻烦 啊 ， 每 个 业务 实现 都 需要 配置 一 个 事务 代理 ， 发 展 到 这 ，Spring 想 出 更 好 的 
解决 方案 ，Spring2.0 及 之 后 版 本 提出 使 用 新 的 “<tx:tags/>" 方 式 配置 事务 ， 从 而 无 需 为 每 个 业 
务实 现 配 置 一 个 代理 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/2506.html]】 


【第 5 九 章 】 Spring 的 事务 9.4 声明 式 事务 
跟 我 学 spring3 


声明 式 事务 
9.4.1 声明 式 事务 概述 


从 上 节 编 程式 实现 事务 管理 可 以 深刻 体会 到 编程 式 事务 的 痛苦 ， 即 使 通过 代理 配置 方式 也 是 
不 小 的 工作 量 。 


本 节 将 介绍 声明 式 事务 支持 ， 使 用 该 方式 后 最 大 的 获 益 是 简单 ， 事 务 管理 不 再 是 令 人 痛苦 
年 实 


的 ， 而 且 此 方式 属于 无 侵入 式 ， 对 业务 逻辑 实 


接 下 来 先 来 看 看 声明 式 事务 如 何 实现 吧 。 


9.4.2 声明 式 实现 事务 
1、 定 义 业务 逻辑 实现 ， 此 处 使 用 ConfigUserServicelmpl 和 ConfigAddressServicelmpl: 
2、 定 义 配 置 文件 (chapter9/service/ applicationContext-service-declare.xml) 


2.1、XML 命 名 空间 定义 ， 定 义 用 于 事务 支持 的 tx 命名 空间 和 AOP 支 持 的 aop 命 名 空间 : 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> 


2.2、 业 务实 现 配 置 ， 非 常 简单 ， 使 用 以 前 定义 的 非 侵入 式 业 务实 现 


<bean id="userService" class="cn.javass.spring.chapter9.service.impl.ConfigUserServiceImp 
<property name="userDao" ref="userDao"/> 
<property name="addressService" ref="addressService"/> 

</bean> 

<bean id="addressService" class="cn.]javass.spring.chapter9.service.impl.ConfigAddressServ 
<property name="addressDao" ref="addressDao"/> 

</bean> 


“| 二 











3、 事 务 相 关 配 置 


<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<tx:method name="save*" propagation="REQUIRED" isolation="READ_ COMMITTED"/> 
<tx:method name="*" propagation="REQUIRED" isolation="READ_ COMMITTED" read-only=" 
</tx:attributes> 
</tx:advice> 


<| = 











<aop:config> 
<aop:pointcut id="serviceMethod" expression="execution(* cn..chapter9,.service..*.*(.. 
<aop:advisor pointcut-ref="serviceMethod" advice-ref="txAdvice"/> 

</aop:config> 


<| ER 








。 <tx:advice> : 事务 通知 定义 ， 用 于 指定 事务 属性 ， 其 中 “transaction-manager” 属 性 指定 
事务 管理 器 ， 并 通过 < tx:attributes > 指定 具体 需要 拦截 的 方法 ; 

。 <tx:method name="save*"> : 表示 将 拦截 以 Save 开头 的 方法 ， 被 拦截 的 方法 将 应 用 配置 
的 事务 属性 : propagation="REQUIRED" 表 示 传 播 行为 是 Required ， 
isolation="READ_COMMITTED" 表 示 隔 离 级 别 是 提交 读 ; 

。 <tx:method name="”"> : 表示 将 拦截 其 他 所 有 方法 ， 被 拦截 的 方法 将 应 用 配置 的 事务 属 
性 : propagation="REQUIRED" 表 示 传 播 行为 是 Required ， 
isolation="READ_COMMITTED" 表 示 隔 离 级 别 是 提交 读 ，read-only="true" 表 示 事 务 只 


读 ; 
e。 <aop:config> : AOP 相 关 配 置 


。 <aop:pointcut/> : 切入 点 定义 ， 定 义 名 为 ' ee 点 ， 切 入 点 表达 
式 为 "execution( cn..chapter9.service...*(..))" 表 示 拦 截 cn 包 包 下 的 chapter9. service 
包 下 的 任何 类 的 任何 方法 ; 
。 <aop:advisor> : Advisor 定 义 ， 其 中 切入 点 为 serviceMethod， 通 知 为 txAdvice 。 


从 配置 中 可 以 看 出 ， 将 对 cn 包 及 子 包 下 的 chapter9. service 包 及 子 包 下 的 任何 类 的 任何 方法 应 
用 “txAdvice” 通 知 指定 的 事务 属性 。 


3、 修 改 测试 方法 并 测试 该 配置 方式 是 否 好 用 : 


将 TransactionTest 类 的 testServiceTransaction 测 试 方法 拷贝 一 份 命名 为 
testDeclareTransaction : 


并 在 testDeclareTransaction 测 试 方法 内 将 : 


classpath:chapter9/service/applicationContext-service.xml" 


替换 为 : 


classpath:chapter9/service/applicationContext-service-declare.xml" 


4、 执 行 测试 ， 测 试 正常 通过 ， 说 明 该 方式 能 正常 工作 ， 当 调用 Save 方 法 时 将 匹配 到 事务 通知 
中 定义 的 “<tx:method name="save">” 中 指定 的 事务 属性 ， 而 调用 countAl| 方 法 时 将 匹配 到 事 
务 通知 中 定义 的 “tx:method name=”">” 中 指定 的 事务 属性 。 


声明 式 事务 是 如 何 实现 事务 管理 的 呢 ? 还 记 不 记得 TransactionProxyFactoryBean 实 现 配置 式 
事务 管理 ， 配 置式 事务 管理 是 通过 代理 方式 实现 ， 而 声明 式 事务 管理 同样 是 通过 AOP 代 理 方 
式 实现 。 


声明 式 事务 通过 AOP 代 理 方 式 实现 事务 管理 ， 利 用 环绕 通知 Transactionlnterceptor 实 现 事务 
的 开启 及 关闭 ， 而 TransactionProxyFactoryBean 内 部 也 是 通过 该 环绕 通知 实现 的 ， 因 此 可 以 
认为 是 <tx:tags/> 帮 你 定义 了 TransactionProxyFactoryBean， 从 而 简化 事务 管理 。 


了 解 了 实现 方式 后 ， 接 下 来 详细 学 习 一 下 配置 吧 : 


9.4.4 <tx:advice/> 配 置 详解 
声明 式 事务 管理 通过 配置 <tx:advice/> 来 定义 事务 属性 ， 配 置 方式 如 下 所 示 : 


<tx:advice id="....." transaction-manager="..."> 
<tx:attributes> 
<tx:method name="....." 

propagation=" REQUIRED" 
isolation="READ_ COMMITTED" 
timeout="-1" 
read-only="false" 
no-rollback-for="" 
rollback-for=""/> 


</tx:attributes> 
</tx:advice> 


。 <tx:advice> : id 用 于 指定 此 通知 的 名 字 ，transaction-manager 用 于 指定 事务 管理 器 ， 默 
认 的 事务 管理 器 名 字 为 “transactionManager”; 
。 <tx:method> : 用 于 定义 事务 属性 即 相关 联 的 方法 名 ; 


name : 定义 与 事务 属性 相关 联 的 方法 名 ， 将 对 匹配 的 方法 应 用 定义 的 事务 属性 ， 可 以 使 
用 “通配符 来 匹配 一 组 或 所 有 方法 ， 如 “save” 将 匹配 以 save 开 头 的 方法 ， 而 将 匹配 所 有 方 
法 ; 

propagation : 事务 传播 行为 定义 ， 默 认为 REQUIRED”， 表 示 Reduired， 其 值 可 以 通过 


TransactionDefinition 的 静态 传播 行为 变量 的 "PROPAGATION "后边 部 分 指定 ， 
如 “TransactionDefinition.PROPAGATION_REQUIRED” 可 以 使 用 REQUIRED” 指定 ; 


isolation : 事务 隔离 级 别 定 义 ; 默认 为 “DEFAULT”， 其 值 可 以 通过 TransactionDefinition 的 静 
态 隔 离 级 别 变量 的 “ISOLATION "后边 部 分 指定 ， 如 “TransactionDefinition. 
ISOLATION_DEFAULT" 可 以 使 用 "DEFAULT” 指 定 : 


timeout : 事务 超时 时 间 设 置 ， 单 位 为 种 ， 默 认 -1， 表 示 事 务 超时 将 依赖 于 底层 事务 系统 ; 


read-only : 事务 只 读 设置 ， 默 认为 false， 表 示 不 是 只 读 ; 


rollback-for : 需要 触发 回 滚 的 异常 定义 ， 以 “，" 分 神 ， 默 认 任何 RuntimeException 将 导致 事 
务 回 滚 ， 而 任何 Checked Exception 将 不 导致 事务 回 滚 ; 异常 名 字 定义 和 
TransactionProxyFactoryBean 中 含义 一 样 


no-rollback-for : 不 被 触发 进行 回 滚 的 Exception(s) ; 以 ，" 分 割 ; 异常 名 字 定 义 和 
TransactionProxyFactoryBean 中 含义 一 样 ; 


记 不 记得 在 配置 方式 中 为 了 解决 “自我 调用 "而 导致 的 不 能 设置 正确 的 事务 属性 问题 ， 使 
用 “((IUserService)AopContext.currentProxy()). EM 式 解决 ， 在 
声明 式 事务 要 得 到 支持 需要 使 用 <aop:config expose-proxy="true"> 来 开启 


9.4.5 多 事务 语义 配置 及 最 佳 实践 


什么 是 多 事务 语 人 因为 我 们 项 目 中 不 可 能 
就 几 个 Bean， 而 可 能 很 多 ， 这 可 能 需要 为 Bean 分 组 ， 为 不 同 组 的 Bean 配 置 不 同 的 事务 语 
义 。 在 Spring 中 ， 可 以 通过 配置 多 切入 点 和 多 事务 通知 并 通过 不 同方 式 组 合 使 用 即 可 。 


1、 首 先 看 下 声明 式 事务 配置 的 最 佳 实践 吧 : 


<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<tx:method name="save*" propagation="REQUIRED" /> 
<tx:method name="add*" propagation="REQUIRED" /> 
<tx:method name="create*" propagation="REQUIRED" /> 
<tx:method name="insert*" propagation="REQUIRED" /> 
<tx:method name="update*" propagation="REQUIRED" /> 
<tx:method name="merge*" propagation="REQUIRED" /> 
<tx:method name="del*" propagation="REQUIRED" /> 
<tx:method name="remove*" propagation="REQUIRED" /> 
<tx:method name="put*" propagation="REQUIRED" /> 
<tx:method name="get*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="count*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="find*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="list*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="*" propagation="SUPPORTS" read-only="true" /> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<aop:pointcut id="txPointcut" expression="execution(* cn.javass..service.*.*(..))" 
<aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut" /> 
</aop:config> 





该 声明 式 事务 配置 可 以 应 付 常见 的 CRUD 接 口 定义 ， 并 实现 事务 管理 ,我们 只 需 修改 切入 点 表 
达 式 来 拦截 我 们 的 业务 实现 从 而 对 其 应 用 事务 属性 就 可 以 了 ， 如 果 还 有 更 复杂 的 事务 属性 直 
接 添加 即 可 ， 即 


如 果 我 们 有 一 个 batchSaveOrUpdate 方 法 需要 “REQUIRES_NEVW” 事 务 传播 行为 ， 则 直接 添加 
如 下 配置 即 可 : 


<tx:method name="batchSaveOrUpdate" propagation="REQUIRES_ NEW" /> 


2、 接 下 来 看 一 下 多 事务 语义 配置 吧 ， 声 明 式 事务 最 佳 实践 中 已 经 配置 了 通用 事务 属性 ， 因 此 
可 以 针对 需要 其 他 事务 属性 的 业务 方法 进行 特例 化 配置 : 


<tx:advice id="noTxAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<tx:method name="*" propagation="NEVER" /> 
</tx:attributes> 
</tx:advice> 
<aop:config> 
<aop:pointcut id="noTxPointcut" expression="execution(* cn.javass..util.*.*())" /> 
<aop:advisor advice-ref="noTxPointcut" pointcut-ref="noTxAdvice" /> 
</aop:config> 


| 
该 声明 将 对 切入 点 匹配 的 方法 所 在 事务 应 用 “Never" 传 播 行 为 。 
多 事务 语义 配置 时 ， 切 入 点 一 定 不 要 有 司 加 ， 否 则 将 应 用 两 次 事务 属性 ， 造 成 不 必要 的 错误 及 


麻烦 。 


9.4.6 @Transactional 实 现 事 务 管理 


对 声明 式 事务 管理 ，Spring 提 供 基 于 @Transactional 注 解 方式 来 实现 ， 但 需要 Java 5+。 


注解 方式 是 最 简单 的 事务 配置 方式 ， 可 以 直接 在 Java 源 代码 中 声明 事务 属性 ， 且 对 于 每 一 个 
业务 类 或 方法 如 果 需 要 事务 都 必须 使 用 此 注解 。 


接 下 来 学 习 一 下 注解 事务 的 使 用 吧 : 


package cn.javass.spring.chapter9.service.impl; 
// 省 略 import 
public class AnnotationUserServiceImp1 implements IUserService { 
private IUserDao userDao; 
private IAddressService addressService; 
public void setUserDao(IUserDao userDao) { 
this.userDao = userDao; 


public void setAddressService(IAddressService addressService) { 
this.addressService = addressService,; 
} 
@Transactional(propagation=Propagation.REQUIRED, isolation=Isolation.READ_ COMMITTED) 
Q@Override 
public void save(final UserModel] user) { 
userDao.save(user); 
user .getAddress().setUserId(user .getId()); 
addressService.save(user.getAddress()); 
} 
@Transactional(propagation=Propagation.REQUIRED, isolation=Isolation.READ_ COMMITTED, 
Q@Override 
public int countAll() { 
return userDao.countAll(); 





2、 定 义 配 置 文件 (chapter9/service/ applicationContext-service-annotation.xml) 


2.1、XML 命 名 空间 定义 ， 定 义 用 于 事务 支持 的 tx 命名 空间 和 AOP 支 持 的 aop 命 名 空间 : 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:tx="http://www.springframework.org/schema/tx" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/tx 
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"> 


2.2、 业 务实 现 配 置 ， 非 常 简单 ， 使 用 以 前 定义 的 非 侵 入 式 业 务实 现 : 


<bean id="userService" class="cn.javass.spring.chapter9.service.impl.ConfigUserServiceImp 
<property name="userDao" ref="userDao"/> 
<property name="addressService" ref="addressService"/> 

</bean> 

<bean id="addressService" class="cn.]javass.spring.chapterg9.service.impl.ConfigAddressSeryv 
<property name="addressDao" ref="addressDao"/> 

</bean> 


二 = 二 = 


2.3、 事 务 相 关 配 置 : 


?| 





<tx:annotation-driven transaction-manager="txManager"/> 


使 用 如 上 配置 已 支持 声明 式 事务 。 


3、 修 改 测 试 方法 并 测试 该 配置 方式 是 否 好 用 : 


将 TransactionTest 类 的 testServiceTransaction 测 试 方法 拷贝 一 份 命名 为 
testAnntation TransactionTest : 


将 测试 代码 片段 : 


classpath:chapter9/service/applicationContext-service.xml" 


替换 为 : 


classpath:chapter9/service/applicationContext-service-annotation.xm]l" 


将 测试 代码 自 


userService,.save(user); 


替换 为 : 


try { 
userService.save(user); 
Assert.fail(); 

} catch (RuntimeException e) { 


} 
Assert.assertEquals(0, userService.countAll()); 
Assert.assertEquals(0, addressService.countAll()); 


4、 执 行 测试 ， 测 试 正 常 通过 ， 说 明 该 方式 能 正常 工作 ， 因 为 在 
AnnotationAddressServicelmpl 类 的 save 方 法 中 抛 出 异常 ， 因 此 事务 需要 回 滚 ， 所 以 两 个 
countAll 操 作 都 返回 0 。 


9.4.7 @Transactional 配 置 详解 


Spring 提供 的 <tx:annotation-driven/> 用 于 开启 对 注解 事务 管理 的 支持 ， 从 而 能 识别 Bean 类 上 
的 @Transactional 注 解 元 数据 ， 其 具有 以 下 属性 : 


。 transaction-manager : 指定 事务 管理 器 名 字 ， 黑 认为 transactionManager， 当 使 用 其 他 
名 字 时 需要 明确 指定 ; 

e proxy-target-class : 表示 将 使 用 的 代码 机 制 ， 黑 认 false 表 示 使 用 JDK 人 代理， 如 果 为 true 将 
使 用 CGLIB 代 理 

。 order : 定义 事务 通知 顺序 ， 黑 认 Ordered.LOWEST_PRECEDENCE， 表 示 将 顺序 决定 
权 交 给 AOP 来 处 理 。 


Spring 使 用 @Transaction 来 指定 事务 属性 ， 可 以 在 接口 、 类 或 方法 上 指定 ， 如 果 类 和 方法 上 
都 指定 了 @Transaction， 则 方法 上 的 事务 属性 被 优先 使 用 ， 具 体 属 性 如 下 : 


evalue : 指定 事务 管理 器 名 字 ， 上 默认 使 用 <tx:annotation-driven/> 指 定 的 事务 管理 器 ， 用 于 
支持 多 事务 管理 器 环境 ; 

。 propagation : 指定 事务 传播 行为 ， 默 认为 Required， 使 用 Propagation.REQUIRED 指 
定 ; 

。 isolation : 指定 事务 隔离 级 别 ， 默 认为 "DEFAULT”， 使 用 Isolation.DEFAULT 指 定 ; 

。 readOnly : 指定 事务 是 否 只 读 ， 默 认 false 表 示 事 务 非 只 读 ; 

。 timeout : 指定 事务 超时 时 间 ， 以 秒 为 单位 ， 默 认 -1 表示 事务 超时 将 依赖 于 底层 事务 系 
统 ; 

。 rollbackFor : 指定 一 组 异常 类 ， 遇 到 该 类 开 常 将 回 滚 事务 ; 

。 rollbackForClassname : 指定 一 组 异常 类 名 字 ， 其 含义 与 <tx:method> 中 的 rollback-for 
属性 语义 完全 一 样 ; 

。 noRollbackFor : 指定 一 组 异常 类 ， 即 使 遇 到 该 类 异常 也 将 提交 事务 ， 即 不 回 滚 事务 ; 

。 noRollbackForClassname : 指定 一 组 异常 类 名 字 ， 其 含义 与 <tx:method> 中 的 no- 
rollback-for 属 性 语义 完全 一 样 ; 


Spring 提供 的 @Transaction 注 解 事务 管理 内 部 同样 利用 环绕 通知 Transactionlnterceptor 实 现 
事务 的 开启 及 关闭 。 


使 用 @Transactional 注 解 事务 管理 需要 特别 注意 以 下 几 点 : 


e。 如 果 在 接口 、 实 现 类 或 方法 上 都 指定 了 @Transactional 注解 ， 则 优先 级 顺序 为 方法 > 实现 
类 > 接口 ; 

e。 建议 只 在 实现 类 或 实现 类 的 方法 上 使 用 @Transactional， 而 不 要 在 接口 上 使 用 ， 这 是 因 
为 如 果 使 用 JDK 代 理 机 制 是 没 问 题 ， 因 为 其 使 用 基于 接口 的 代理 ; 而 使 用 使 用 CGLIB 代 理 
机 制 时 就 会 遇 到 问题 ， 因 为 其 使 用 基于 类 的 代理 而 不 是 接口 ， 这 是 因为 接口 上 的 
@Transactional 注 解 是 “不 能 继承 的 ”; 


具体 请 参考 基于 JDK 动 态 代理 和 CGLIB 动 态 代理 的 实现 Spring 注解 管理 事务 
(@Trasactional) 到 底 有 什么 区 别 。 


。 在 Spring 代理 机 制 下 (不 管 是 JDK 动 态 代理 还 是 CGLIB 代 理 )，“ 自 我 调用 "同样 不 会 应 用 相 
应 的 事务 属性 ， 其 语义 和 <tx:tags> 中 一 样 ; 

。 默认 只 对 RuntimeException 异 常 回 滚 ; 

。 在 使 用 Spring 代理 时 ， 默 认 只 有 在 public 可 见 度 的 方法 的 @Transactional 注解 才 是 有 效 
的 ， 其 它 可 见 度 (protected、private、 包 可 见 ) 的 方法 上 即使 有 @Transactional 注解 也 
不 会 应 用 这 些 事 务 属性 的 ，Spring 也 不 会 报错 ， 如 果 你 非 要 使 用 非 公共 方法 注解 事务 管理 
的 话 ， 可 考虑 使 用 AspectJ。 


9.4.9 与 其 他 AOP 通 知 协作 


Spring 声明 式 事 务实 现 其 实 就 是 Spring AOP+ 线 程 绑 定 实现 ， 利 用 AOP 实 现 开启 和 关闭 事务 ， 
利用 线程 绑 定 (ThreadLocal) 实现 跨越 多 个 方法 实现 事务 传播 。 


由 于 我 们 不 可 能 只 使 用 一 个 事务 通知 ， 可 能 还 有 其 他 类 型 事务 通知 ， 而 且 如 果 这 些 通知 中 需 
要 事务 支持 怎么 办 ? 这 就 牵扯 到 通知 执行 顺序 的 问题 上 了 ， 因 此 如 果 可 能 与 其 他 AOP 通 知 协 
作 的 话 ， 而 且 这 些 通 知 中 需要 使 用 声明 式 事务 管理 支持 ， 事 务 通 知 应 该 具有 最 高 优先 级 。 


9.4.10 声明 式 or 编 程式 


编程 式 事务 时 不 推荐 的 ， 即 使 有 很 少 事务 操作 ，Spring 发 展 到 现在 ， 没 有 理由 使 用 编程 式 事 
务 ， 只 有 在 为 了 深入 理解 Spring 事 务 管理 才 需 要 学 习 编 程式 事务 使 用 。 


推荐 使 用 声明 式 事务 ， 而 且 强烈 推荐 使 用 <tx:tags> 方 式 的 声明 式 事务 ， 因 为 其 是 无 侵入 代码 
的 ， 可 以 配置 模板 化 的 事务 属性 并 运用 到 多 个 项 目 中 。 


而 @Transaction 注 解 事务 ， 可 以 使 用 ， 不 过 作者 更 倾向 于 使 用 <tx:tags> 声 明 式 事务 


能 保证 项 目 正 常 工 作 的 事务 配置 就 是 最 好 的 。 


9.4.11 混合 事务 管理 


所 谓 混 合 事务 管理 就 是 混合 多 种 数据 访问 技术 使 用 ， 如 混合 使 用 Spring JDBC + Hibernate ， 
接 下 来 让 我 们 学 习 一 下 常见 混合 事务 管理 : 


1、 Hibernate + Spring JDBC/iBATIS : 使 用 HibernateTransactionManager 即 可 支持 ; 
2、JPA+ Spring JDBC/iBATIS : 使 用 JpaTransactionManager 即 可 支持 ; 
3、JDO + Spring JDBC/iBATIS : 使 用 JtaTransactionManager 即 可 支持 ; 


混合 事务 管理 最 大 问题 在 于 如 果 我 们 使 用 第 三 方 ORM 框 架 ， 如 Hibernate， 会 遇 到 一 级 及 二 级 
缓存 问题 ， 尤 其 是 二 级 缓存 可 能 造成 如 使 用 Spring JDBC 和 Hibernate 查 询 出 来 的 数据 不 一 致 


A 


于 o 
因此 不 建议 使 用 这 种 混合 使 用 和 混合 事务 管理 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2508.html] 


【第 十 章 】 集 成 其 它 Web 框 架 之 10.1 概述 一 一 跟 
我 学 spring3 


10.1 概述 


10.1.1 Spring 和 Web 框 架 


Spring 框架 不 仅 提 供 了 一 套 自己 的 Web 框 架 实现 ， 还 支持 集成 第 三 方 Web 框 架 (如 Struts1X、 
Struts2x) 。 


Spring 实现 的 SpringMVC Web 框 架 将 在 第 十 八 章 详细 介绍 。 


由 于 现在 有 很 大 部 分 公司 在 使 用 第 三 方 Web 框 架 ， 对 于 并 不 熟悉 SpringMVC Web 框 架 的 公 
司 ， 为 了 充分 利用 开发 人 员 AAA ， 想 集成 所 使 用 的 Web 框 架 ; 
由 于 Spring 框架 的 高 度 可 配置 和 可 选择 性 ， 因 此 集成 这 些 第 三 方 Web 框 架 是 非常 简单 的 。 


之 所 以 想 把 这 些 第 三 方 Web 框 架 集成 到 Spring 中 ， 最 核心 的 价值 是 享受 Spring 的 某 些 强大 功 
能 ， 如 一 致 的 数据 访问 ， 事 务 管理 ，IOC，AOP 等 等 。 

Spring 为 所 有 Web 框 架 提 供 一 致 的 通用 配置 ， 从 而 不 管 使 用 什么 Web 框 架 都 使 用 该 通用 配 
置 。 


10.1.2 通用 配置 
Spring 对 所 有 VVeb 框 架 抽象 出 通用 配置 ， 以 减少 重复 配置 ， 其 中 主要 有 以 下 配置 : 
1、Web 环 境 准 备 : 


1.1、 在 spring 项 目下 创建 如 图 10-1 目 录 结 构 : 


日 2 spring 
由 -图 - settings 
山 - 攻 lib 


BB resour ces 







wabapp 
BE WEB-IE 
+ classes 








图 10-1 web 目 录 结 构 


1.2、 右 击 spring 项 目 选择 【Propeties】， 然 后 选择 【Java Build Path】 中 的 【Source】 选 
项 卡 ， 将 类 输出 路 径 修 改 为 “spring/webapp/WEB-INF/classes”， 如 图 10-2 所 示 : 
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图 10-2 修改 类 输出 路 径 


1.3、web.xml 初 始 内 容 如 下 : 


<?xml1 version="1.0" encoding="UTF-8"?> 

<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> 

</web-app> 


<web-app version="2.4"> 表 示 采 用 Servlet 2.4 规 范 的 Web 程 序 部 署 描述 格式 


2、 指 定 Web 应 用 上 下 文 实现 : 在 Web 环 境 中 ，Spring 提 供 WebApplicationContext (继承 
ApplicationContext) 接口 用 于 配置 Web 应 用 ， 该 接口 应 该 被 实现 为 在 Web 应 用 程序 运行 时 只 
读 ， 即 在 初始 化 完毕 后 不 能 修改 Spring Web 容 器 (WebApplicationContext) ， 但 可 能 支持 重 
载 。 


Spring 提供 XmlWebApplicationContext 实 现 ， 并 在 Web 应 用 程序 中 默认 使 用 该 实现 ， 可 以 通 
过 在 web.xml 配 置 文件 中 使 用 如 下 方式 指定 : 


<context-param> 
<param-name>contextClass</param-name> 
<param-value> 
org.springframework.web.context.support.XmlwebApplicationContext 
</param-value> 
</context-param> 


如 上 指定 是 可 选 的 ， 只 有 当 使 用 其 他 实现 时 才 需 要 显示 指定 。 


3、 指 定 加 载 文件 位 置 
前 边 已 经 指定 了 Spring Web 容 器 实现 ， 那 从 什么 地 方 加 载 配 置 文件 呢 ? 


默认 情况 下 将 加 载 /WEB-INF/applicationContext.xml 配 置 文件 ， 当 然 也 可 以 使 用 如 下 形式 在 
web.xml 中 定义 要 加 载 自 定义 的 配置 文件 ， 多 个 配置 文件 用 “，” 分 割 : 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value> 
classpath:chapter10/applicationContext-message.xml 
</param-value> 
</context-param> 


通用 1Sprng 配置 文件 〈resources/chapter10/applicationContext-message.xml) 内 容 如 下 所 


小 多 


<bean id="message" class="java, lang,String"> 
<constructor-arg index="0" value="Hello Spring"/> 
</bean> 


4、 加 载 和 关闭 Spring Web 容 器 : 


我 们 已 经 指定 了 Spring Web 容 器 实现 和 配置 文件 ， 那 如 何 才 能 让 Spring 使 用 相应 的 Spring 
Web 容 器 实现 加 载 配置 文件 呢 ? 


Spring 使 用 ContextLoaderListener 监 听 器 来 加 载 和 关闭 Spring Web 容 器 ， 即 使 用 如 下 方式 在 
web.xml 中 指定 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


ContextLoaderListener 监 听 器 将 在 Web 应 ， 动 时 使 用 指定 的 配置 文件 初始 化 Spring Web 容 
器 ， 在 Web 应 用 关闭 时 销毁 Spring Web 容 


监听 器 是 从 Servlet 2.3 才 开始 支持 的 ， 因 此 如 果 Web 应 用 所 运行 的 环境 是 Servlet 2.2 版 本 
则 人 完成 ， 但 从 Spring3.x 版 本 之 后 ContextLoaderServlet 被 移 
除了 。 
5、 在 Web 环 境 中 获取 Spring Web 容 器: 


既然 已 经 定义 了 Spring Web 容 器 ， 那 如 何在 Web 中 访问 呢 ? Spring 提供 如 下 方式 来 支持 获取 
Spring Web 容 器 (WebApplicationContext) 


WebApplicationContextUtils.getwebApplicationContext(servletContext); 


或 


WebApplicationContextUtils.getRequiredwebApplicationContext(servletContext); 


如 果 当 前 Web 应 用 中 的 ServletContext 中 没有 相应 的 Spring Web 容 器 ， 对 于 
getWebApplicationContext() 方 法 将 返回 null， 法 将 抛 

常 ， 建 议 使 用 第 二 种 方式 ， 因 为 缺失 Spring Web 容 器 而 又 想 获取 它 ， 很 明显 是 错误 的 ， 
应 该 抛 出 异常 。 


6、 通 用 jar 包 ， 从 下 载 的 spring-framework-3.0.5.RELEASE-with-docs.zip 中 dist 目 录 查 找 
如 下 jar 包 


。 org.springframework.web-3.0.5.RELEASE.jar 
此 jar 包 为 所 有 Web 框 架 所 共有 ， 提 供 WebApplicationContext 及 实现 等 。 
7、Web 服 务 器 选择 及 测试 : 


目前 比较 流行 的 支持 Servlet 规 范 的 开源 Web 服 务 器 包括 Tomcat、Resin、Jetty 等 ，Web 服 务 
器 有 独立 运行 和 吝 入 式 运行 之 分 ， 嵌 入 式 Web 服 务 器 可 以 在 测试 用 例 中 运行 不 依赖 于 外 部 环 
境 ， 因 此 我 们 使 用 诅 入 式 Web 服 务 器 


O 


Jetty 是 一 个 非常 轻 量 级 的 Web 服 务 器 ， 并 且 提 供 具 入 式 运 行 支持 ， 在 此 我 们 选用 Jetty 作 为 测 
试 使 用 的 Web 服 务 器 。 


7.1、 准 备 Jetty 襄 入 式 Web 服 务 器 运行 需要 的 jar 包 : 


该 心 jetty 包 
# 工 具 jetty 包 2 


libyjsp-2. 1%ant-l, Siar 

libyjsp-2.1Wore-3.1,1.jar« 

lib\isp-2.1Ysp-2.1-glassfish-2.1.w20091210.jar 前 sb2.1 支持 相关 jar 包 + 
lib\jsp-2.1Ysp-2.1-jetty-6.1.24.1ar+ 
lib\jsp-2.1jsp-api-2.1-glassfish-2.1.w20091210.jare 





7.2、 在 单元 测试 中 启动 Web 服 务 器 : 


package cn.javass.spring.chapter10; 
import org.junit.Test; 
Import org.mortbay.jetty.Server,; 
import org.mortbay.jetty.webapp.wWebAppContext; 
public class WebFrameworkIntegrateTest { 
@Test 
public void testwebFramework() throws Exception { 
Server server = new Server(8080); 
WebAppContext webapp = new WebAppContext(); 
webapp.setResourceBase("webapp"); 
//webapp.setDescriptor("webapp/WEB-INF/web .xml"); 
webapp.setContextPath("/"); 
webapp.setclassLoader(Thread.currentThread().getContextCclassLoader()); 
server.setHandler (webapp); 
server.start(); 
server .join(); 
//server.stop(); 


} 


。 创建 内 吝 式 Web 服 务 器 : 使 用 new Server(8080) 新 建 一 个 Jetty 服 务 器 ， 监 听 端 口 为 
8080; 

。 创建 一 个 Web 应 用 : 使 用 new WebAppContext() 新 建 一 个 Web 应 用 对 象 ， 一 个 Web 应 用 
可 以 认为 就 是 一 个 WebAppContext 对 象 ; 

e 指定 Web 应 用 的 目录 : 使 用 webapp.setResourceBase("webapp") 指 定 Web 应 用 位 于 项 目 
根 目 录 下 的 “webapp” 目 录 下 ; 

。 指定 部 署 描述 符 : 使 用 webapp.setDescriptor("webapp/WEB-INF/web.xml") ; 此 处 指定 
部 署 描述 符 为 项 目 根 目录 下 的 “webapp/WEB-INF/web.xml”"， 该 步骤 是 可 选 的 ， 如 果 
web.xml 位 于 Web 应 用 的 WEB-INF 下 。 

。 指定 Web 应 用 请 求 上 下 文 : 使 用 webapp.setContextPath("/") 指 定 请 求 上 下 文 为 *， 从 而 
访问 该 Web 应 用 可 以 使 用 如 “http://localhost:8080/hello.do” 形 式 访问 ; 

e 指定 类 装载 器 : 因为 Jetty 自 带 的 ClassLoader 在 内 寿 环 境 中 对 中 文 路 径 处 理 有 问题 ， 因 此 
我 们 使 用 Eclispe 的 ClassLoader， 即 通 


过 “webapp.setClassLoader(Thread. Guren ihieadt, getContextClassLoader()) "指定 ; 
。 户 动 Web 服 务 器 : 使 用 “server.start()" 启 动 并 使 用 “server.join()" 保 证 Web 服 务 器 一 直 运 
行 ; 
。 四 Web 让 分 冤 : 可 以 通过 某 种 方式 执行 “Server.stop()”" 来 关闭 Web 服 务 器 ; ee 


关 
是 通过 【Console】 人 台面 板 的 【Terminate】 终 止 按钮 关闭 ， 如 图 10-3 所 示 


[ 国 允 [日 cosol。 5、 . | 加 | 、 | 
守 11:20:41) 一 一 一 I 
.JspWriter from sun.misc.Lau Terminatej- 

















图 10-3 点 击 红色 按钮 关闭 Web 服 务 器 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2510.html] 


【第 十 章 】 集 成 其 它 Web 框 架 之 10.2 集成 
Struts1.x 一 一 跟 我 学 spring3 


先进 行 通用 配置 ， 【第 十 章 】 集 成 其 它 Web 框 架 之 10.1 概述 


10.2 集成 Struts1.x 


10.2.1 概述 


Struts1.x 是 最 早 实现 MYC (模型 -视图 -控制 器 ) 模式 的 Web 框 架 之 一 ， 其 使 用 非常 广泛 ， 虽 然 
目前 已 经 有 Struts2.X 等 其 他 Web 框 架 ， 但 仍 有 很 多 公司 使 用 Struts1.x 框 架 。 


集成 Struts1.Xx 也 非常 简单 ， 除 了 通用 配置 外 ， 有 两 种 方式 可 以 将 Struts1.X 集 成 到 Spring 中 : 


。 最 简单 集成 : 使 用 Spring 提 供 的 WebApplicationContextUtils 工 具 类 中 的 获取 Spring Web 
容器 ， 然 后 通过 Spring Web 容 器 获取 Spring 管理 的 Bean ; 

。 Struts1.x 插 件 集成 : 利用 Struts1.x 中 的 插件 ContextLoaderPlugin 来 将 Struts1.x 集 成 到 
Spring 中 。 


接 下 来 让 我 们 首先 让 我 们 准备 Struts1x 所 需要 的 jar 包 


1.1、 从 下 载 的 spring-framework-3.0.5.RELEASE-with-docs.zip 中 dist 目 录 查 找 如 下 jar 
包 ， 该 jar 包 用 于 提供 集成 struts1.x 所 需要 的 插件 实现 等 


。 org.springframework.web.struts-3.0.5.RELEASE.jar 


1.2、 从 下 载 的 spring-framework-3.0.5.RELEASE-dependencies.zip 中 查找 如 下 依赖 jar 
包 ， 该 组 jar 是 struts1.x 需 要 的 jar 包 


e。 com.springsource.org.apache.struts-1.2.9.jar //struts1.2.9 实 现 包 

。 com.springsource.org.apache.commons.digester-1.8.1.jar /用 于 解析 struts 配 置 文件 
。 com.springsource.org.apache.commons.beanutils-1.8.0.jar /用 于 请 求 参 数 绑 定 

e。 com.springsource.javax.servlet-2.5.0.jar /Servlet 2.5 API 

e antlrjar // 语 法 分 析 包 (已 有 ) 

。 commons-logging.jar // 日 志 记 录 组 件 包 (已 有 ) 

。 servlet-api.jar //Servlet API 包 (已 有 ) 

。 jsp-api.jar //JSP API 包 (已 有 ， 可 选 ) 

。 commons-validator.jar // 验 证 包 (可 选 ) 
。 commons-fileupload.jar // 文 件 上 传 包 ( 可 选 ) 


10.2.2 最 简单 集成 


只 使 用 通用 配置 ， 利 用 WebApplicationContextUtils 提 供 的 获取 Spring Web 容 器 方法 获取 
Spring Web 容 器 ， 然 后 从 Spring Web 容 器 获取 Spring 管理 的 Bean。 


1、 第 一 个 Action 实 现 : 


package cn.javass.spring.chapter10.strutsix.action; 
import org.apache.struts.action.Action; 
// 省 略 部 分 import 
public class Hellowor1ldAction1 extends Action { 
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletReque 


WebApplicationContext ctx = WebApplicationContextUtils. 
getRequiredwebApplicationContext(getServlet().getServletContext()); 

String message = ctx.getBean("message", String.class); 

request.setAttribute("message", message); 

return mapping.findForward("hello"); 





此 Action 实 现 非常 简单 ， 首 先 通过 WebApplicationContextUtils 获 取 Spring Web 容 器 ， 然 后 从 


Spring Web 容 器 中 获取 “message"Bean 并 将 其 放 到 request 里 ， 最 后 转 到 “hello" 所 代表 的 jsp 页 
:7 


2、JSP 页 面 定 义 (webapp/WEB.-INF/jsp/hello.jsp) 


<%@ page language="java" pageEncoding="UTF-8" 
contentType="text/html; charset=UTF-8" %> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 

<title>Hello World</title> 
</head> 
<body> 

${message} 
</body> 
</html> 


3、 配 置 文件 定义 : 
3.1、Spring 配 置 文件 定义 〈resources/chapter10/applicationContext-message.xml ) 


在 此 配置 文件 中 定义 我 们 使 用 的 “message”"Bean ; 


<bean id="message" class="java.lang.string"> 


<constructor-arg index="0" value="Hello Spring"/> 
</bean> 


3.2、struts 配 置 文件 定义 (resources/chapter10/struts1x/struts-config.xml) 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!IDOCTYPE struts-config PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" 
"http://jakarta.apache.org/struts/dtds/struts-config 1 1.dtd"> 
<struts-config> 
<action-mappings> 
<action path="/hello" type="cn.javass.spring.chapter10.strutsix.action.HelloworldActi 
<forward name="hello" path="/WEB-INF/jsp/hello.jsp"/> 
</action> 
</action-mappings> 
</struts-config> 
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3.3、Wweb.xml 部 署 描述 符 文 件 定义 (webapp/WEB-INF/web.xml) 添加 如 下 内 容 : 


<1-- Struts1.,x 前 端 控制 器 配置 开始  --> 
<servlet> 
<servlet-name>hello</servlet-name> 
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class> 


<init-param> 
<param-name>config</param-name> 
<param-value> 
/WEB-INF/classes/chapter10/struts1ix/struts-config.xml 
</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
<servlet-name>hello</servlet-name> 
<url-pattern>*.do</url-pattern> 
</servlet-mapping> 
<1-- Struts1.X 前 端 控制 器 配置 结束 --> 


Struts1.x 前 端 控制 器 配置 了 ActionServlet 前 端 控制 器 ， 其 拦截 以 .do 开头 的 请 求 ，Strut 配 置 
件 通过 初始 Ne ， 如果 不知 道 “config” 参 数 则 默认 加 载 的 配置 文件 为 WEB- 
INF/ struts-config.Xxm 


4、 执 行 测试 : 在 Web 浏 览 器 中 输入 http://localhost:8080/hello.do 可 以 看 到 “Hello Spring” 信 息 
说 明 测 试 正常 。 


有 朋友 想 问 ， 我 不 想 使 用 这 种 方式 ， 我 想 在 独立 环境 内 测试 ， 没 关系 ， 您 只 需 将 
录 找 贝 到 Spring/webapp/WEB-INF/ 下 ， 然 后 将 webapp 拷 贝 到 如 tomcat 中 即 可 运行 ， 党 试 一 下 
P 巴 


Spring 还 提供 ActionSupport 类 来 简化 获取 WebApplicationContext，Spring 为 所 有 标准 Action 
类 及 子 类 提供 如 下 支持 类 ， 即 在 相应 Action 类 后 边 加 上 Support 后 级 : 


ActionSupport 


DispatchActionSupport 


LookupDispatchActionSupport 


MappingDispatchActionSupport 
具体 使 用 方式 如 下 : 


1、Action 定 义 


package cn.javass.spring.chapter10.strutsix.action,; 

// 省 略 import 

public class HelloworldAction2 extends ActionSupport { 

public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest r 
WebApplicationContext ctx = getwebApplicationContext(); 
String message = ctx.getBean("message", String.class); 
request.setAttribute("message", message); 
return mapping.findForward("hello"); 


<| 








和 第 一 个 示例 唯一 不 同 的 是 直接 调用 getWebApplicationContext() 即 可 获得 Spring Web 容 


2、 修 改 Struts 配 置 文件 (resources/chapter10/struts1x/struts-config.xml) 添加 如 下 
Action 定 义 : 
<action path="/hello2" type="cn.javass.spring.chapter10.strutsix.action.HelloworldAction2 


<forward name="hello" path="/WEB-INF/jsp/hello.jsp"/> 
</action> 


了 "| 


3、 局 et a 并 在 Web 浏 览 器 中 输入 http://localhost:8080/hello2.do 可 以 看 
到 “Hello Spring" 信 息 说 明 Struts1 集 成 成 功 。 


这 种 集成 方式 好 吗 ? 而 且 这 种 方式 莫 是 集成 吗 ? 直接 获取 Spring Web 容 器 然后 从 该 Spring 
Web 容 器 中 获取 Bean， 暂 且 看 作 是 集成 吧 ， 这 种 集成 对 于 简单 操作 可 以 接受 ， 但 更 复杂 的 注 
入 呢 ? 接 下 来 让 我 们 学 习 使 用 Struts 播 件 进行 集成 。 


10.2.2 Struts1.X 插 件 集 成 


Struts 插 件 集成 使 用 ContextLoaderPlugin 类 ， 该 类 用 于 为 ActionServlet 加 载 Spring 配置 文件 。 


1、 在 Struts 配 置 文件 (resources/chapter10/struts1x/struts-config.xml) 中 配置 插件 : 


<plug-in className="org.springframework.web.struts.ContextLoaderPlugIn"> 
<set-property property="contextClass" value="org.springframework.web.context.support. 
<set-property property="contextCconfigLocation" value="/WEB-INF/hello-servlet.xml"/> 
<set-property property="namespace" value="hello"/> 

</plug-in> 


人 Eee 


。 contextClass : 可 选 ， 用 于 指定 WebApplicationContext 实 现 类 ， 默 认 是 
XmlWebApplicationContext ; 
。 contextConfigLocation : 指定 Spring 配置 文件 位 置 ， 如 果 我 们 的 ActionServlet 在 
Web.xml 里 面 通过 <servlet-name>hello</servlet-name> 指 定名 字 为 “hello"， 且 没有 指定 
contextConfigLocation， 则 默认 Spring 配置 文件 是 /WEB-INF/hello-servlet.xml ; 





。 namespace : 因为 默认 使 用 ActionServlet 在 web.xml 定 义 中 的 Servlet 的 名 字 ， 因 此 如 果 
想 要 使 用 其 他 名 字 可 以 使 用 该 变量 指定 ， 如 指定 “hello"， 将 加 载 的 Spring 配置 文件 
为 /WEB-INF/hello-servlet.xml ; 


由 于 我 们 的 ActionServlet 在 web.xml 中 的 名 字 为 hello， 而 我 们 的 配置 文件 在 WEB-INF/hello- 
servlet.xml， 因 此 contextConfigLocation 和 namespace 可 以 不 指定 ， 因 此 最 简单 配置 如 下 : 


<plug-in className="org.springframework.web.struts.ContextLoaderPlugIn"/> 


通用 配置 的 Spring Web 容 器 将 作为 ContextLoaderPlugin 中 创建 的 Spring Web 容 器 的 父 容器 存 
， 然 而 可 以 省 略 通用 配置 而 直接 在 Struts 配置 文件 中 通过 ContextLoaderPlugin 插 件 指定 所 有 
己 直 置 文件 5 


插件 已 经 配置 了 ， 那 如 何 定 义 Action、 配 置 Action、 配 置 Spring 管 理 Bean 呢 ， 即 如 何 站 正 集成 
Spring+Struts1x 呢 ?使 用 插件 方式 时 Action 将 在 Spring 中 配置 而 不 是 在 Struts 中 配置 了 ， 
Spring 目前 提供 以 下 两 种 方式 : 


e。 将 Struts 配 置 文件 中 的 <action> 的 type 属 性 指定 为 DelegatingActionProxy， 然 后 在 Spring 
中 配置 同名 的 Spring 管理 的 Action Bean ; 

。 使 用 Spring 提供 的 DelegatingRequestProcessor 重 载 Struts 默认 的 RequestProcessor 来 
从 Spring 容器 中 查找 同名 的 Spring 管理 的 Action Bean 。 


看 履 了 吗 ? 好 像 没 怎么 看 懂 ， 那 就 直接 上 代码 ， 有 代码 有 昌 相 。 


2、 定 义 Action 实 现 ， 由 于 Action 将 在 Spring 中 配置 ， 因 此 message 可 以 使 用 依赖 注入 方式 
本 人 


package cn.javass,.Sspring.chapter10.struts1x.action， 
// 省 略 
public class HelloworldAction3 extends Action { 
private String message; 
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletReque 


request.setAttribute("message", message); 
return mapping.findForward("hello"); 


public void setMessage(String message) {// 有 setter 方 法 ， 否 想到 Setter 注 入 
this.message = message 





3、DelegatingActionProxy 方 式 与 Spring 集成 配置 


3 . 1、 在 Struts 配 置 文件 (resources/chapter10/struts1x/struts-config.xml) 中 进行 
Action 定 义 : 


<action path="/hello3" type="org.springframework.web.struts.DelegatingActionProxy"> 
<forward name="hello" path="/WEB-INF/jsp/hello.jsp"/> 
</action> 


3.2、 在 Spring 配置 文件 《webapp/WEB-INF/hello-servlet.xml) 中 定义 Action 对 应 的 
Bean : 


<bean name="/hello3" class="cn.]javass.spring.chapter10.strutsix.action.HelloworldAction3" 
<property name="message" ref="message"/> 
</bean> 


J a | 


3.3、 局 eb 并 在 Web 浏 览 器 中 输入 http://localhost:8080/hello3.do 可 以 看 
到 “Hello Spring” 信 息 说 明 测试 正常 





从 以 上 配置 中 可 以 看 出 : 


. Sh Sn 的 path 属 性 和 Spring 配置 文件 的 name 属 性 应 该 完全 一 样 ， 
否则 错误 ; 
。 Struts 通 过 DelegatingActionProxy 去 到 Spring Web 容 器 中 查找 同名 的 Action Bean ; 


很 简单 吧 ，DelegatingActionProxy 是 个 代理 Action， 其 实现 了 Action 类 ， 其 内 部 帮 有 我 们 查找 相 
应 的 Spring 管理 Action Bean 并 把 请 求 转发 给 这 个 丨 实 的 Action。 


4、DelegatingRequestProcessor 方 式 与 Spring 集 成 : 


4.1、 首 先 要 替换 掉 Struts 默 认 的 RequestProcessor， 在 Struts 配 置 文件 
(resources/chapter10/struts1x/struts-config.xml) 中 添加 如 下 配置 


<controller> 
<Set-property property="processorClass" 
value="org.springframework.web.struts.DelegatingRequestProcessor"/> 
</controller> 


4 2、 在 Struts 配 置 文件 (resources/chapter10/struts1x/struts-config.xml) 中 进行 
Action 定 义 : 


<action path="/hello4" type=" cn.javass.spring.chapter10.strutsix.action.HelloworldAction 
<forward name="hello" path="/WEB-INF/jsp/hello.jsp"/> 
</action> 


Eee 
或 更 简单 形式 : 





<action path="/hello4"> 
<forward name="hello" path="/WEB-INF/jsp/hello.jsp"/> 
</action> 


4.3、 在 Spring 配置 文件 (webapp/WEB-INF/hello-servlet.xml) 中 定义 Action 对 应 的 
Bean : 


<bean name="/hello4" class="cn.javass.spring.chapter10.strutsix.action.HelloworldAction3" 
<property name="message" ref="message"/> 
</bean> 


加 a a 


4.4、 户 动 说 入 式 Web 服 务 器 并 在 Web 浏 览 器 中 输入 http://localhost:8080/hello4.do 可 以 看 
到 “Hello Spring” 信 息 说 明 Struts1 集 成 成 功 。 





从 以 上 配置 中 可 以 看 出 : 


。 Struts 配 置 文件 中 <action> 标 签 的 path 铬 性 和 Spring 配 置 文件 的 name 属 性 应 该 完全 一 样 ， 


否则 错误 ; 
。 Struts 通 过 DelegatingRequestProcessor 去 到 Spring Web 容 器 中 查找 同名 的 Action 
Bean ; 


很 简单 吧 ， 只 是 由 DelegatingRequestProcessor 去 帮 我 们 查找 相应 的 Action Bean， 但 没有 
代理 Action 了， 所 以 推荐 使 用 该 方式 。 
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专用 Sprine Web 春 器 


图 10-4 共享 及 专用 Spring Web 容 


专用 3pring Weshb 春 器 


Struts1x 与 Spring 集成 到 此 就 完成 了 ， 在 集成 时 需要 注意 一 下 几 点 : 


。 推荐 使 用 ContextLoaderPlugin+DelegatingRequestProcessor 方 式 集成 ; 

。 当 有 多 个 Struts 模 块 时 建议 在 通用 配置 部 分 配置 通用 部 分 ， 因 为 通用 配置 在 正在 Web 容 器 
中 是 可 共享 的 ， 而 在 各 个 Struts 模 块 配置 文件 中 配置 是 不 可 共享 的 ， 因 此 不 推荐 直接 使 用 
ContextLoaderPlugin 中 为 每 个 模块 都 指定 所 有 配置 ， 因 为 ContextLoaderPlugin 加 载 的 
Spring 容器 只 对 当前 的 ActionServlet 有 效 对 其 他 ActionServlet 无 效 ， 如 图 10-4 所 示 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPostlist/2511.html] 


【第 十 章 】 集 成 其 它 Web 框 架 之 10.3 集成 
Struts2.x 一 一 跟 我 学 spring3 


先进 行 通用 配置 ， 【第 十 章 】 集 成 其 它 Web 框 架 之 10.1 概述 


10.3 集成 Struts2.x 


10.3.1 概述 


Struts2 前 身 是 WebWork， 核 心 并 没有 改变 ， 其 实 就 是 把 WebWork 改 名 为 struts2， 与 Struts1 
一 点 关系 没有 。 


Struts2 中 通过 ObjectFactory 接 口 实现 创建 及 获取 Action 实 例 ， 类 似 于 Spring 的 IloC 容 器 ， 所 以 
Action 实 例 可 以 由 ObjectFactory 实 现 来 管理 ， 因 此 集成 Spring 的 关键 点 就 是 如 何 创建 
ObjectFactory 实 现 来 从 Spring 容器 中 获取 相应 的 Action Bean 。 


Struts2 提 供 一 个 默认 的 ObjectFactory 接 口 实现 StrutsSpringObjectFactory， 该 类 用 于 根据 
Struts2 配 置 文件 中 相应 Bean 信 息 从 Spring 容器 中 获取 相应 的 Action 。 


此 Struts2.x 与 Spring 集成 需要 使 用 StrutsSpringObjectFactory 类 作为 中 介 者 。 
接 下 来 让 我 们 首先 让 我 们 准备 Struts2x 所 需要 的 jar 包 


准备 Struts2.x 需 要 的 jar 包 ， 到 Struts 官 网 http://struts.apache.org/ 下 载 struts-2.2.1.1 版 
本 ， 拷 贝 如 下 jar 包 到 项 目的 lib 目 录 下 并 添加 到 类 路 径 : 


。 lib\struts2-core-2.2.1.1.jar // 核 ee 

。 lib\xwork-core-2.2.1.1.jar /命令 框架 包 ， 独 立 于 Web 环 境 ， 为 Struts2 
e。 // 提 供 核心 功能 的 支持 包 

lib\freemarker-2.3.16.jar // 提 供 模板 化 UI 标签 及 视图 技术 支持 
lib\ognl-3.0.jar // 对 象 图 导航 工具 包 ， 类 似 于 SpEL 

lib\ struts2-spring-plugin-2.2.1.1.jar // 集 成 Spring 的 插件 包 
libxcommons-logging-1.0.4.jar // 日 志 记 录 组 件 包 (已 有 ) 
libicommons-fileupload-1.2.1.jar // 用 于 支持 文件 上 传 的 包 


10.3.2 使 用 ObjectFactory 集 成 


1、Struts2.x 的 Action 实现 : 


package cn.javass.spring.chapter10.struts2x.action; 
Import org.apache,.struts2.ServletActionContext 
Import com.opensymphony .xwork2.ActionSupport 
public class HelloworldAction extends ActionSupport { 
private String message 
Q@Override 
public String execute() throws Exception { 
ServletActionContext.getRequest().setAttribute("message", message); 
return "hello"; 


public void setMessage(String message) {//setter 注 入 
this.message = message; 
} 


2、JSP 页 面 定 义 ， 使 用 Struts1x 中 定义 的 JSP 页 面 “webapp/WEB-INF/jsp/hello.jsp”; 


3、Spring 一 般配 置 文件 定义 (resources/chapter10/applicationContext- 
message.xml) 


在 此 配置 文件 中 定义 我 们 使 用 的 “message”"Bean ; 


<bean id="message" class="java.lang.string"> 
<constructor-arg index="0" value="Hello Spring"/> 
</bean> 


4、Spring Action 配置 文件 定义 (resources/chapter10/hello-servlet.xml) 


<bean name="helloAction" class="cn.javass.spring.chapter10.struts2x.action.HelloworldActi 
<property name="message" ref="message"/> 
</bean> 


== 产 关 ns 


Struts2 的 Action 在 Spring 中 配置 ， 而 且 应 该 是 prototype， 因 为 Struts2 的 Action 是 有 状态 的 ， 
定义 在 Spring 中 ， 那 Struts 如 何 找到 该 Action 呢 ? 





5、struts2 配 置 文件 定义 (resources/chapter10/struts2x/struts.xml) 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<constant name="struts.objectFactory" value="org.apache.struts2.spring.StrutsSpringOb 
<constant name="struts.devMode" value="true"/> 
<package name="default" extends="struts-default"> 
<action name="hello" class="helloAction"> 
<result name="hello" >/WEB-INF/jsp/hello.jsp</result> 
</action> 
</package> 
</struts> 
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。 struts.objectFactory : 通过 在 Struts 配 置 文件 中 使 用 常量 属性 struts.objectFactory 来 定 


义 Struts 将 要 使 用 的 ObjectFactory 实 现 ， 此 处 因为 需要 从 Spring 容器 中 获取 Action 对 象 ， 
因此 需要 使 用 StrutsSpringObijectFactory 来 集成 Spring ; 

。 <action name="hello" class="helloAction"> : StrutsSpringObjectFactory 对 象 工厂 将 根 
据 <action> 标 签 的 class 属 性 去 Spring 容器 中 查找 同名 的 Action Bean ; 即 本 例 中 将 到 
Spring 容器 中 查找 名 为 helloAction 的 Bean。 


6、web.xml 部 署 描述 符 文件 定义 (webapp/WEB-INF/web.xml) 


6.1、 由 于 Struts2 只 能 使 用 通用 配置 ， 因 此 需要 在 通用 配置 中 加 入 Spring Action 配 置 文件 
(chapter10/struts2x/struts2x-servlet.xml ) 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value> 
classpath:chapter10/applicationContext-message.xml, 
classpath:chapter10/struts2x/struts2x-servlet.xml 
</param-value> 
</context-param> 


Struts2 只 能 在 通用 配置 中 指定 所 有 Spring 配置 文件 ， 并 没有 如 Struts1 自 己 指定 Spring 配置 文 
件 的 实现 。 


6.2、Strut2 前 端 控制 器 定义 ， 在 Web.xml 中 添加 如 下 配置 


<1-- Struts2.,x 前 端 控制 器 配置 开始 。 --> 
<filter> 
<filter-name>struts2x</filter-name> 
<filter-class>org.apache,.struts2.dispatcher.FilterDispatcher</filter-class> 
<init-param> 
<param-name>config</param-name> 
<param-value> 
struts-default.xm]l,struts-plugin.xml,chapter1i0/struts2x/struts.xm]l 
</param-value> 
</init-param> 
</filter> 
<filter-mapping> 
<filter-name>struts2x</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping> 
<1-- Struts2.X 前 端 控制 器 配置 结束 --> 


ER i 


。 FilterDispatcher : Struts2 前 端 控制 器 为 FilterDispatcher， 是 Filter 实 现 ， 不 是 Servlet; 

。 config : 通过 初始 化 参数 config 指 定 配置 文件 为 struts-default.xml，struts-plugin.xml， 
chapter10/struts2x/struts.xml ; 如 果 不 知道 该 参数 则 默认 加 载 struts-default.xml，struts- 
plugin.xml，struts.xml( 位 于 webapp/WEB-INF/classes 下 ) ; 显示 指定 时 需要 将 struts- 
default.xml，struts-plugin.xml 也 添加 上 。 

。*.action : 将 拦截 以 “action" 结 尾 的 HTTP 请 求 ; 

。 struts2x : FilterDispatcher 前 端 控制 器 的 名 字 为 struts2x， 因 此 相应 的 Spring 配置 文件 名 
为 struts2x-servlet.xml 。 


7、 执 行 测试 ， 在 Web 浏 览 器 中 输入 http://localhost:8080/hello.action 可 以 看 到 “Hello 
Spring” 信 息 说 明 Struts2 集 成 成 功 。 


集成 Strut2 也 是 非常 简单 ， 在 此 我 们 总 结 一 下 吧 : 
e。 配置 文件 位 置 : 


Struts 配 置 文件 默认 加 载 “struts-default.xml,struts-plugin.xml, struts.xml"， 其 中 struts- 
default.xml 和 struts-plugin.xml 是 Struts 自 带 的 ， 而 struts.xml 是 我 们 指定 的 ， 默 认 位 于 
webapp/WEB-INF/classes 下; 


如 果 需 要 将 配置 文件 放 到 其 他 位 置 ， 需 要 在 web.xml 的 <filter> 标 签 下 ， 使 用 初始 化 参数 config 
指定 ， 如 “struts-default.xml ，struts-plugin.xml，chapter10/struts2x/struts.xml”， 其 中 “struts- 
default.xml 和 struts-plugin.Xxmp 是 不 可 省 略 的 ， 黑 认 相 对 路 径 是 类 路 径 。 


。 集成 关键 ObjectFactory : 在 Struts 配 置 文件 或 属性 文件 中 使 用 如 下 配置 知道 使 用 
StrutsSpringObjectFactory 来 获取 Action 实 例 : 


在 struts.xml 中 指定 : 


<constant name="struts.objectFactory”value='"org.apache,struts2.spring.StrutsSpringobJject 
剧 和 ee ;| 


或 在 struts.properties 文 件 (webapp/WEB-INF/classes/) 中 : 





Struts.objectFactory=org.apache,struts2.spring,StrutsSpringobjectFactory 


。 集成 关键 Action 定 义 : 
StrutsSpringObjectFactory 将 根据 Struts2 配 置 文件 中 的 <action class=”> 标 签 的 classes 属 性 名 
字 去 到 Spring 配置 文件 中 查找 同名 的 Bean 定 义 ， 这 也 是 集成 的 关键 。 


=<action name='"hello" class="helloAction">. 


</action>+ 


<bean name="helloAction" class="Action 类 全 限定 名 " scope="prototype">。 


</bean>. 





。 Spring 配置 文件 中 Action 定 义 : 由 于 Struts2 的 Action 是 有 状态 的 ， 因 此 应 该 将 Bean 定 义 
为 prototype 。 


如 图 10-5，Sturt2 与 Spring 集成 的 关键 就 是 StrutsSpringObjectFactory， 注 意图 只 是 说 明 Struts 
与 Spring 如 何 通过 中 介 者 StrutsSpringObjectFactory 来 实现 集成 ， 不 能 代表 实际 的 类 交互 。 


通用 配置 





通用 配置 文件 


共享 Spring Web 容 器 


(et 


> 


* /hello .action | 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2512.html] 


图 10-5 Strut2 与 Spring 集 成 
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先进 行 通用 配置 ， 【第 十 章 】 集 成 其 它 Web 框 架 之 10.1 概述 


10.4 集成 JSF 


10.4.1 概述 


JSF (JavaServer Faces) 框架 是 Java EE 标准 之 一 ， 是 一 个 基于 组 件 及 事件 驱动 的 Web 框 
架 ，JSF 只 是 一 个 标准 (规范) ， 目 前 有 很 多 厂家 实现 ， 如 Oracle 的 默认 标准 实现 Mojarra、 
Apache 的 MyFaces、Jboss 的 RichFaces 等 。 


本 示例 将 使 用 Oracle 标 准 实现 Mojarra， 请 到 官网 http://javaserverfaces.java.net/ 下 载 最 新 的 
JSF 实 现 。 


JSF 目 前 有 JSF1.1、JSF1.2、JSF2 版 本 实现 。 
Spring 集成 JSF 有 三 种 种 方式 : 


。 最 简单 集成 : 使 用 FacesContextUtils 工 具 类 的 getWebApplicationContext 方 法 ， 类 似 于 
Struts1x 中 的 最 简单 实现 ; 

。 VariableResolver 实 现 : Spring 提 供 javax.faces.el.VariableResolver 的 两 种 实现 
DelegatingVariableResolver 和 SpringBeanVariableResolver， 此 方式 适用 于 JSF1.1、 
JSF1.2 及 JSF2， 但 在 JSF1.2 和 JSF2 中 不 推荐 使 用 该 方式 ， 而 是 使 用 第 三 种 集成 方式 ; 

。 ELResolver 实 现 : Spring 提供 javax.el.ELResolver (Unified EL) 实现 
SpringBeanFacesELResolver 用 于 集成 JSF1.2 和 JSF2。 


接 下 来 让 我 们 首先 让 我 们 准备 JSF 所 需要 的 jar 包 : 
首先 准备 JSF 所 依赖 的 包 : 


。 commons-digesterjar /必须 ， 已 有 

。 commons-collections.jar /必须 ， 已 有 
。 commons-beanutils.jar /必须 ， 已 有 
e。 jsp-apijar /必须 ， 已 有 

。 servlet-api.jar /必须 ， 已 有 

jstljar /可 选 

standard.jar /可 选 


准备 JSF 包 ， 到 http://javaserverfaces.java.net/ 下 载 相应 版 本 的 Mojarra 实 现 ， 如 下 载 
JSF1.2 实 现 mojarra-1.2_15-b01-FCS-binary.zip， 找 贝 如 下 jar 包 到 类 路 径 : 


。 lib\jsf-api.jar /JSF 规 范 接口 包 
。 lib\jsf-impl.jar //JSF 规 范 实现 包 
10.4.2 最 简单 集成 


类 似 于 Struts1x 中 的 最 简单 集成 ，Spring 集 成 JSF 也 提供 类 似 的 工具 类 FacesContextUtils， 使 
用 如 下 方式 获取 WebApplicationContext : 


WebApplicationContext ctx = FacesContextUtils.getwebApplicationContext(FacesContext.getCu 
加 二 = 美语 
当然 我 们 不 推荐 这 种 方式 ， 而 是 推荐 使 用 接 下 来 介绍 的 另外 两 种 方式 。 





10.4.2 使 用 VariableResolver 实 现 集成 


Spring 提供 javax.faces.el.VariableResolver 的 两 种 实现 DelegatingVariableResolver 和 
SpringBeanVariableResolver， 其 都 是 Spring 与 JSF 集 成 的 中 介 者 ， 此 方式 适用 于 JSF1.1、 
JSF1.2 及 JSF2 : 


。 DelegatingVariableResolver : 首先 委托 给 JSF 默 认 VariableResolver 实 现 去 查找 JSF 管 理 
Bean， 如 果 找 不 到 再 委托 给 Spring 容器 去 查找 Spring 管理 Bean ; 

。 SpringBeanVariableResolver : 其 与 DelegatingVariableResolver 查 找 正好 相反 ， 首 先 委 
托 给 Spring 容 器 去 查找 Spring 管理 Bean ， 如 果 找 不 到 再 委托 给 JSF 默 认 VariableResolver 
实现 去 查找 JSF 管 理 Bean。 


接 下 来 看 一 下 如 何在 JSF 中 集成 Spring 吧 (本 示例 使 用 JSF1.2， 其 他 版 本 的 直接 替换 jar 包 即 
可 ) 


1、JSF 管 理 Bean (Managed Bean ) 实现 : 


package cn.javass.spring.chapter10.jsf; 
public class HelloBean { 
private String message; 
public void setMessage(String message) { 
this.message = message; 


} 

public String getMessage() { 
return message; 

} 


} 


2、JSF 配 置 文件 定义 (resources/chapter10/jsf/faces-config.xml) 


<?xml1 version="1.0" encoding="UTF-8"?> 

<faces-config version="1.2" xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/w 


<application> 
<variable-resolver> 
org.springframework .web.jsf.DelegatingVariableResolver 
</variable-resolver> 
</application> 


<managed-bean> 
<managed-bean-name>helloBean</managed-bean-name> 
<managed-bean-class> 
cn.javass.spring.chapter10.jsf.HelloBean 
</managed-bean-class> 
<managed-bean-scope>request</managed-bean-scope> 
<managed-property> 
<property-name>message</property-name> 
<value>#{message}</value> 
</managed-property> 
</managed-bean> 
</faces-config> 


-| 下 


。 与 Spring 集成 : 通过 <variable-resolver> 标 签 来 指定 集成 Spring 的 中 介 者 
DelegatingVariableResolver ; 





。 注入 Spring 管理 Bean : 通过 <managed-property> 标 签 的 <value>#{message}</value> 
注入 Spring 管 理 Bean“"message”。 


4、JSP 页 面 定 义 (webapp/hello-jsf.jsp) 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<!DOCTYPE htm]l PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN™" "http://www.w3.org/TR/html 
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
<f:view> 
<html> 
<head> 
<title>Hello World</title> 
</head> 
<body> 
<h:outputText value="#{helloBean.message}"/> 
</body> 
</html> 
</f:view> 


MM ss ss a 


5、JSF 前 端 控制 器 定义 ， 在 web.xml 中 添加 如 下 配置 : 





指定 JSF 配 置 文件 位 置 ， 通 过 javax.faces.CONFIG_FILES 上 下 文 初 始 化 参数 指定 JSF 配 置 文 
件 位 置 ， 多 个 可 用 “，” 分 割 ， 如 果 不 指定 该 参数 则 默认 加 载 的 配置 文件 为 WEB-INF/ faces- 
config.xml” : 


<1-- JSF 配 置 文件 开始 --> 

<Context-param> 
<param-name>javax.faces,.CONFIG_FILES</param-name> 
<param-value> 

/WEB-INF/classes/chapter10/jsf/faces-config-jsf1ix.xml 

</param-value> 

</context-param> 

<1-- JSF 配 置 文件 结束 --> 


前 端 控制 器 定义 : 使 用 FacesServlet 作 为 JSF 的 前 端 控制 器 ， 其 拦截 以 "jsf" 结尾 的 HTTP 请 


<1-- jsf 前 端 控 制 器 配置 开始 - -> 

<servlet> 
<servlet-name>jsf</servlet-name> 
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class> 

</servlet> 

<servlet-mapping> 
<servlet-name>jsf</servlet-name> 
<url-pattern>*.jsf</url-pattern> 

</servlet-mapping> 

<1-- jsf 前 端 控 制 器 配置 结束 。 --> 


7、 执 行 测 试 ， 在 Web 浏 览 器 中 输入 http://localhost:8080/hello-jsf.jsp 可 以 看 到 “Hello 
Spring” 信 息 说 明 JSF 集 成 成 功 。 


自 此 ，JSF 集 成 Spring 已 经 成 功 ， 在 此 可 以 把 DelegatingVariableResolver 替 换 为 
SpringBeanVariableResolver， 其 只 有 在 查找 相应 依赖 时 顺序 是 正好 相反 的 ， 其 他 完全 一 样 。 


如 果 您 的 项 目 使 用 JSF1.2 或 JSF2， 推 荐 使 用 SpringBeanFacesELResolver， 因 为 其 实 标准 的 
Unified EL 实现 ， 而 且 VariableResolver 接 口 已 经 被 注释 为 @Deprecated， 表 示 可 能 在 以 后 的 
版 本 中 去 掉 该 接口 。 


10.4.2 使 用 ELResolver 实 现 集成 


JSF1.2 之 前 ，JSP 和 JSF 各 个 使 用 自己 的 一 套 表达 式 语言 (EL Language) ， 即 如 JSF 使 用 
VariableResolver 实 现 来 解析 JSF EL 表达 式 ， 而 从 JSF1.2 和 JSP2.1 开 始 使 用 Unified EL， 从 而 
级 0 了 表达 式 语言 号 


此 集成 JSF1.2+ 可 以 通过 实现 Unified EL 来 完成 集成 ， 即 Spring 提供 ELResolver 接 口 实现 
SpringBeanFacesELResolver 用 于 集成 使 用 。 


类 似 于 VariableResolver 实 现 ， 通 过 SpringBeanFacesELResolver 集 成 首先 将 从 Spring 容器 中 
查找 相应 的 Spring 管理 Bean， 如 果 没 找到 再 通过 默认 的 JSF ELResolver 实 现 查找 JSF 管 理 
Bean。 


接 下 来 看 一 下 示例 一 下 吧 : 


1、 添 加 Unified EL 所 需要 的 jar 包 : 


。 el-api.jar //Unified EL 规范 接口 包 
由 于 在 Jetty 中 已 经 包含 了 该 api， 因 此 该 步骤 可 选 。 
2、 修改 JSF 配 置 文件 (resources/chapter10/jsfffaces-config.xml ) 


将 如 下 配置 


<variable-resolver> 
org.springframework.web.jsf.DelegatingVariableResolver 
</variable-resolver> 


修改 为 : 


<el-resolver> 
org.springframework.web.jsf.el.SpringBeanFacesELResolver 
</el-resolver> 


3、 执 行 测试 ， 在 Web 浏 览 器 中 输入 http://localhost:8080/hello-jsf.jsp 可 以 看 到 “Hello 
Spring” 信 息 说 明 JSF 集 成 成 功 。 


自 此 JSF 与 Spring 集成 就 算 结束 了 ， 是 不 是 也 很 简单 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/0/2513.html] 
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11.1 概述 


11.1.1 功能 概述 


本 节 将 通过 介绍 一 个 积分 商城 系统 来 演示 如 何 使 用 SSH 集 成 进行 开发 。 


积分 商城 一 般 是 购物 网 站 的 子 模块 ， 提 供 一 些 礼品 或 商品 用 于 奖励 老 用 户 或 使 用 积分 来 折 换 
成 现金 ， 如 图 11-1 所 示 。 


购物 网 站 


每 天 在 线 10 小 时 加 50 积 分 每 100 积 分 换 10 元 人 民 币 


购买 促销 产品 加 0 积分 使 用 积分 部 换 礼品 





图 11-1 购物 网 站 与 积分 商城 

积分 商城 功能 点 : 

。 后 台 管 理 

交易 管理 模块 : 用 于 查看 积分 交易 历史 ; 

商品 管理 模块 : 用 于 CRUD 积 分 兑换 商品 ; 

日 报 或 月 报 : 用 于 发 送 给 运营 人 员 每 日 积分 兑换 情况 ， 一 般 通 过 email 发 送 ; 


商品 展示 : 展示 给 用 户 可 以 使 用 积分 兑换 的 商品 ; 
支付 模块 : 用 户 成 功 兑换 商品 后 扣除 用 户 相应 积分 


添加 积分 模块 : 提供 接口 用 于 其 他 产品 赠送 积分 使 用 ， 如 每 天 在 线 10 小 时 赠送 50 积 分 ， 购 买 
相应 商品 增加 相应 积分 ; 


订单 管理 模块 : 订单 管理 模块 可 以 使 用 现 有 购物 平台 的 订单 管理 。 


购物 平台 、 用 户 系统 及 积分 商城 交互 如 图 11-2 所 示 ， 其 中 用 户 系统 负责 用 户 登 录 ， 购 物 平 台 是 
购物 网 站 核心 ， 积 分 商城 用 于 用 户 使 用 积分 购买 商品 。 







用 户 登 录 时 跳 到 


用 户 系 统 调用 积分 商城 接口 加 积分 






每 天 在 线 10 小 时 加 50 积 


图 11-2 购物 平台 、 用 户 系统 及 积分 商城 交互 





由 于 积分 商城 也 是 很 复杂 ， 由 于 篇 幅 原因 不 打工 完全 介绍 ， 只 介绍 其 中 一 个 模块 商品 
(兑换 码 ) 管理 及 购买 ， 该 模块 主要 提供 给 用 户 使 用 积分 兑换 一 些 优 惠 券 或 虚拟 物品 〈 如 移 
动 充值 卡 ) 等 等 。 


11.1.2 技 术 选 型 


由 于 本 节 是 关于 SSH 集 成 的 ， 因 此 选用 技术 如 下 : 


。 平台 : Java EE ; 

。 运行 环境 : Windows XP，JDK1.6 ; 

。 编辑 器 : Eclipse3.6 + SpringSource Tool Suite ; 

。 Web 容 器 : tomcat6.0.20; 

e 数据 库 : mysql5.4.3; 

框架 : Struts2.0.14、Spring3.0.5、Hibernate3.6.0.Final ; 
。 日 志 记 录 : log4j1.2.15 : 

数据 库 连接 池 : proxool0.9.1 ; 

视图 技术 : JSP 2.0。 


技术 选 定 了 ， 应 该 考虑 平台 架构 了 ， 这 关系 到 项 目的 成 功 与 否 。 


11.1.3 系 统 架 构 


积分 商城 系统 架构 也 将 采用 经 典 的 三 层 架 构 ， 如 图 11-3 所 示 : 


技术 : Hibernate 


技术 : Struts2、JSP 


污 湾 


数 
据 
模 
型 
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所 
. 
局 





图 11-3 三 层 架 构 


分 层 的 目的 是 约束 层次 边界 ， ee 的 职责 和 目标 应 明确 和 单一 ， 每 层 专注 自己 的 事情 ， 不 要 
跨越 分 层 边界 ， 具 体 每 层 功 能 


e 数据 访问 层 : 封装 底层 数据 库 或 文件 系统 访问 细节 ， 从 而 对 业务 逻辑 层 提供 一 致 的 接 
口 ， 使 业务 逻辑 层 不 关心 底层 细节 ; 
。 业务 逻辑 层 : 专注 于 业务 逻辑 实现 ， 不 关心 底层 如 何 访 问 ， 并 在 该 层 实 现 如 声明 式 事务 
管理 ， 组 装 分 页 对 象 ; 
。 表现 层 : 应 该 非常 轻 量 级 及 非常 " 薄 (功能 非常 少 ， 几 乎 全 是 es ， 拦截 用 户 请 求 并 响 
应 ， 表 现 层 数 据 验 证 ， 负 责 根据 请 求 委 托 给 业务 逻辑 层 进行 业务 处 理 ， 本 层 不 实现 任何 
业务 逻辑 ， 且 提供 用 户 交互 界面 ; 
数据 模型 层 : 数据 模型 定义 ， 提 供给 各 层 使 用 ， 不 应 该 前 作 三 层 架 构 中 的 菜 一 层 ， 因 为 
数据 模型 可 使 用 其 他 对 象 (如 Map) 代替 之 。 


系统 架构 已 选 定 ， 在 此 我 们 进行 优化 一 下 ， 因 为 在 进行 基于 SSH 的 三 层 架 构 进 行 开发 时 通常 
会 有 一 些 通用 功能 、 如 通用 DAO、 通 用 Service、 通 用 Action、 通 用 翻 页 等 等 ， 因 此 我 们 再 进 
行 开发 时 都 是 基于 通用 功能 进行 的 ， 能 节省 不 少 开发 时 间 ， 从 而 可 以 使 用 这 此 节约 的 时 间 干 
自己 想 干 的 事情 ， 如 图 10-4 所 示 。 
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图 10-4 基于 通用 层 的 三 层 架构 


11.1.4 项 目 搭建 
1、 创 建 动 态 Web 工 程 : 


通过 【File】>【New】> 【other】>【Web】>【Dynamic Web Project】 创 建 一 个 Web 工 程 ， 
如 图 11-5 所 示 ; 





ic Web Project 


Dynamic Web Project < New Server Runtime Environment 三 
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图 11-5 Web 工 程 配 置 


1、 项目 结构 ， 如 图 11-6 所 示 : 
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六 


跟 我 学 Spring 系列 





EH-E> polntShop 
"BE .settines 


-CE resources esources: 放置 配置 文件 ; 
-BE sq sql: 放置 DDL 或 DML 语句 ， 如 数据 库 创 建 语句 ;，。 
“src Cc: java 文件 位 置 ; 
本 VebContent: web 项 目 根 目录 ; ， 
白 - 它 业 B-ITI classes: 存放 编译 好 的 class 文件 ; 
jsp: 放置 jsp 视图 文件 ; 
lib 放置 jar 包 ; 
web.xml: Web 项 目 部 署 描述 符 文件 。。 


[> 中 TA-IIF 


[0 web. xml 
风 .classpath 





0 .project , 
图 11-6 项 目 结构 
3、 项 目 属性 修改 
3.1、 字 符 编码 修改 ， 如 图 11-7 所 示 ， 在 实际 项 目 中 一 定 要 统一 字符 编码 : 
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图 11-7 修改 项 目 字 符 编 码 


3.2、 类 路 径 输 出 修改 ， 如 图 11-8， 将 类 路 径 输 出 改 为 /WEB-INF/classes 下 : 
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图 11-8 类 路 径 修 改 


4、 准 备 jar 包 : 


4.1 


、Spring 项 目 依赖 包 ， 到 下 载 的 spring-framework-3.0.5.RELEASE-with-docs.zip 中 找 


贝 如 下 jar 包 : 


4.2 


dist\org.springframework.aop-3.0.5.RELEASE.jar 
dist\org.springframework.asm-3.0.5.RELEASE.jar 
dist\org.springframework.beans-3.0.5.RELEASE.jar 
dist\org.springframework.context-3.0.5.RELEASE.jar 
dist\org.springframework.core-3.0.5.RELEASE.jar 
dist\org.springframework.expression-3.0.5.RELEASE.jar 
dist\org.springframework.jdbc-3.0.5.RELEASE.jar 
dist\org.springframework.orm-3.0.5.RELEASE.jar 
dist\org.springframework.transaction-3.0.5.RELEASE.jar 
dist\org.springframework.web-3.0.5.RELEASE.jar 


、Spring 及 其 他 项 目 依赖 包 ， 到 spring-framework-3.0.5.RELEASE-dependencies.zip 


中 拷贝 如 下 jar 吧 : 


com.springsource.net.sf.cglib-2.2.0.jar 
com.springsource.org.aopalliance-1.0.0.jar 
com.springsource.org.apache.commons.beanutils-1.8.0.jar 
com.springsource.org.apache.commons.collections-3.2.1.jar 
com.springsource.org.apache.commons.digester-1.8.1.jar 


e。 com.springsource.org.apache.commons.logging-1.1.1.jar 
e。 com.springsource.org.apache.log4j-1.2.15.jar 

e。 com.springsource.org.apache.taglibs.standard-1.1.2.jar 
e。 com.springsource.org.aspectj.weaver-1.6.8.RELEASE.jar 


4.3、Hibernate 依 赖 包 ， 到 hibernate-distribution-3.6.0.Final.zip 中 拷贝 如 下 jar 包 : 


。 hibernate3.jar 

e。 libljpa\hibernate-jpa-2.0-api-1.0.0.Final.jar 
。 lib\required\dom4j-1.6.1.jar 

e。 lib\required\javassist-3.12.0.GA.jar 

e。 lib\required\jta-1.1.jar 

。 lib\required \slf4j-api-1.6.1.jar 

。 lib\required\antlr-2.7.6.jar 


4.4、 数 据 库 连接 池 依 赖 包 ， 到 proxool-0.9.1.zip 中 拷贝 如 下 jar 包 : 


lib\proxool-0.9.1.jar 


lib\proxool-cglib.jar 
4.5、 准 备 mysql JDBC 连 接 依赖 包 : 
。 mysdqdl-connector-java-5.1.10.jar 


4.6、slf4j 依 赖 包 准 备 ， 到 下 载 的 slf4j-1.6.1.zip 包 中 拷贝 如 下 jar 包 : 


slf4j-log4j12-1.6.1.jar 
4.7、Strut2 依 赖 包 ， 到 struts-2.2.1.1.zip 中 拷贝 如 下 jar 包 : 


e lib\struts2-core-2.2.1.1.jar 

e libxwork-core-2.2.1.1.jar 

。 lib\freemarker-2.3.16.jar 

e lib\ognl-3.0.jar 

e lib\struts2-spring-plugin-2.2.1.1.jar 
。 libcommons-fileupload-1.2.1.jar 


jar 包 终于 准备 完了 ， 是 不 是 很 头疼 啊 ， 在 此 推荐 使 用 maven 进 行 依赖 管理 ， 无 需 找 贝 这 么 多 
jar 包 ， 而 是 通过 配置 方式 来 指定 使 用 的 依赖 ， 具 体 maven 知 识 请 到 官方 网 站 
http://maven.apache.org/ 了 解 。 


原创 内 容 ， 转 载 请 注 明 出 处 【http://sishuok.com/forum/blogPost/list/2514.html] 
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11.2 实现 通用 层 


11.2.1 功能 概述 


过 抽象 通用 的 功能 ， 从 而 复 用 ， 减 少 重 复工 作 : 


e。 对 于 一 些 通用 的 常量 使 用 一 个 专门 的 常量 类 进行 定义 ; 

。 页 ， 也 应 该 抽象 出 来 ， 如 JSP 做 出 JSP 标 签 ; 

e 通用 的 数据 层 代 码 ， 如 通用 的 CRUD， 减 少 重复 劳动 ， 节 约 时 间 ; 

e。 通用 的 业务 逻辑 层 代 码 ， 如 通用 的 CRUD， 减 少 重复 劳动 ， 节 约 时 间 ; 
e。 通用 的 表现 层 人 代码， 同样 用 于 减少 重复 ， 并 提供 更 好 的 代码 结构 规范 


11.2.2 通用 的 第 


目标 : 在 一 个 常量 类 中 定义 通用 的 常量 的 好 处 是 如 果 需 要 修改 这 些 常量 值 只 需 在 一 个 地 方 修 
改 即 可 ， 变 的 地 方 只 有 一 处 而 不 是 多 处 。 


如 默认 分 页 大 小 如 果 在 多 处 硬 编码 定义 为 10， 突 然 发 生变 故 需 要 将 默认 分 页 大 小 10 为 5， 怎 么 
办 ?如 果 当 初 我 们 提取 出 来 放 在 一 个 通用 的 常 、 o 


package cn.javass.commons; 

public class Constants { 
public static final int DEFAULT_PAGE_SIZE = 5;  // 黑 认 分 页 大 小 
public static final String DEFAULT_PAGE_NAME = "page"; 
public static final String CONTEXT_PATH = "ctx"; 


} 
如 上 代码 定义 了 通用 的 常量 ， 如 默认 分 页 大 小 。 


11.2.2 通 用 分 页 功能 


分 页 功能 是 项 目 中 必 不 可 少 的 功能 ， 因 此 通用 分 页 功能 十 分 有 必要 ， 有 了 通用 的 分 页 功能 ， 
即 有 了 规范 ， 从 而 保证 视图 页 面 的 干净 并 节约 了 开发 时 间 。 


1、 分 页 对 象 定义 ， 用 于 存放 是 否 有 上 一 页 、 当 前 页 记录 、 当 前 页 码 、 分 页 上 下 文 ， 
该 对 象 是 分 页 中 必 不 可 少 对 象 ， 一 般 在 业务 逻辑 层 组 装 Page 对 象 ， 然 后 传送 到 表现 层 展 示 ， 
然后 通用 的 分 页 标签 使 用 该 对 象 来 决定 如 何 显示 分 Co 


package cn.javass.commons.pagination; 

import java.util.Collections; 

import java.util.List; 

public class Page<E> {/** 表示 分 页 中 的 一 页 。*/ 
private boolean hasPre; // 是 否 有 上 一 页 
private boolean hasNext; // 是 否 有 下 一 页 
private List<E> items; // 当 前 页 包含 的 记录 列表 
private int index; /7 当前 页 页 码 ( 起 始 为 1) 
// 省 咯 setter 
public int getIndex() { 

return this.index; 


public boolean isHasPre() { 
return this.hasPpre; 


} 
public boolean isHasNext() { 
return this.hasNext ， 


public List<E> getItems() { 
return this.items == nul1 ? Collections.<E>emptyList() : this.items,; 
} 


2 、 分 页 标签 实现 ， 将 使 用 Page 对 象 数据 决定 如 何 展 示 ， 如 图 11-9 和 11-10 所 示 : 


5 研 认 设计 模式 【网 于】 
的 过 一 本 什 得 反复 阅读 的 书 [is 阿 订 设计 模 式 
上 一 页 1 2 3 下 一 页 「 一 三 现 | [ 共 3 页 ] ”上 上 一 页 下 一 页 『 ”中转 | [ 共 3 页 











图 11-9 11-10 通用 分 页 标签 实现 


图 11-9 和 11-10 展 示 了 两 种 分 页 示 策 略 ， 由 于 分 页 标签 和 集成 SSH 没 多 大 关系 且 不 是 必须 的 
并 由 于 篇 幅 问 题 不 再 列 出 分 页 标签 源 代码 ， 有 兴趣 的 朋友 请 参考 
ens set gn 文件 。 代 码 下 载 地 址 


11.2.3 通用 数据 访问 层 
目标 过 抽象 实现 最 基本 的 CURD 操 作 ， 提 高 代码 复 用 ， 可 变 部 分 按 需 实现 。 


通用 数据 访问 层 接 口 定义 


package cn.javass.commons .dao ; 
import java.io.Serializable; 
import java.util.List; 
public interface IBaseDao<M extends Serializable, PK extends Serializable> { 
public void save(M model1);// 保存 模型 对 象 
public void saveOrUpdate(M model);// 保存 或 更 新 模型 对 象 
public void update(M model);// 更 新 模型 对 象 
public void merge(M model);// 合并 模型 对 象 状态 到 底层 会 话 
public void delete(PK id);// 根据 主键 删除 模型 对 象 
public M get(PK id);// 根据 主键 获取 模型 对 象 
public int countA11() ;// 统 计 模 型 对 象 对 应 数据 库 表 中 的 记录 数 
public List<M> 1istAll( );// 查 询 所 有 模型 对 象 
public List<M> 1istAll(int pn，int pageSize);// 分 页 获取 所 有 模型 对 象 


通用 DAO 接 口 定义 了 如 CRUD 通 用 操作 ， 而 可 变 的 (如 查询 所 有 已 发 布 的 接口 ， 即 有 条 件 查 
询 等 ) 需要 在 相应 DAO 接 口中 定义 ， 并 通过 泛 型 “M" 指 定数 据 模 型 类 型 和 “PK" 指 定数 据 模型 主 
键 类 型 。 


2、 通 用 数据 访问 层 DAO 实 现 


此 处 使 用 Hibernate 实 现 ， 即 实现 是 可 变 的 ， 对 业务 逻辑 层 只 提供 面向 接口 编程 ， 从 而 隐藏 数 
据 访 问 层 实现 细节 。 


实现 时 首先 通过 反射 获取 数据 模型 类 型 信息 ， 并 根据 这 些 信息 获取 Hibernate 对 应 的 数据 模型 
的 实体 名 ， 再 根据 实体 名 组 装 出 通用 的 查询 和 统计 记录 的 HQL， 从 而 达到 同样 目的 。 


注意 我 们 为 什么 把 实现 生成 HQL 时 放 到 init 方 法 中 而 不 是 构造 器 中 呢 ? 因为 SessionFactory 是 
通过 setter 注 入 ，setter 注 入 晚 于 构造 器 注入 ， 因 此 在 构造 器 中 使 用 SessionFactory 会 是 null， 
因此 放 到 init 方 法 中 ， 并 在 Spring 配置 文件 中 指定 初始 化 方法 为 init 来 完成 生成 HQL 。 


package cn.javass.commons.dao.hibernate; 
// 为 节省 篇 幅 省 略 import 
public abstract class BaseHibernateDao<M extends Serializable, PK extends Serializable> e 
private Class<M> entityClass; 
private String HQL_LIST_ALL; 
private String HQL_COUNT_ALL; 
@sSuppresswarnings("unchecked") 
public void init() {// 通 过 初始 化 方法 在 依赖 注入 完毕 时 生成 HQL 
//1、 通 过 反射 获取 注解 4M”( 即 模型 对 象 ) 的 类 类 型 
this.entityClass = (Class<M>) ((ParameterizedType) getcClass().getGenericSuperclas 
//2、 得 到 模型 对 象 的 实体 名 
String entityName = getSessionFactory().getClassMetadata(this.entityClass).getEent 
//3、 根 据 实体 名 生成 HQL 
HQL_LIST_ALL = "from " + entityName; 
HQL_COUNT_ALL = " select count(*) from " + entityName; 


} 
protected String getListAllHql1() {// 获 取 查 询 所 有 记录 的 HQL 
return HQL_LIST_ALL; 


} 
protected String getCountAllHq1l() {// 获 取 统 计 所 有 记录 的 HQL 
return HQL_COUNT_ALL; 


public void save(M model) { 
getHibernateTemplate().save(model); 


public void saveOrUpdate(M model) { 
getHibernateTemplate().saveOrUpdate(model); 


public void update(M model) { 
getHibernateTemplate().update(model); 
} 


public void merge(M model) { 
getHibernateTemplate().merge(model); 


} 
public void delete(PK id) { 
getHibernateTemplate().delete(this.get(id)); 


} 
public M get(PK id) { 
return getHibernateTemplate().get(this.entityClass, id); 


} 

public int countAll() { 
Number total = unique(getCountAllHq1()); 
return total.intValue(); 


public List<M> listAll() { 
return list(getListAllHq1()); 


} 


Es======= > 


} 

public List<M> listAll(int pn, int pageSize) { 
return list(getListAllHql(), pn, pageSize); 

} 


protected <T> List<T> list(final String hql, final Object... paramlist) { 
return list(hql，-1，-1，paramlist );// 查 询 所 有 记录 


} 
/** 通用 列表 查询 , 当 pn<=-1 且 pageSize<=-1 表 示 查 询 所 有 记录 
* @param <T> 模型 类 型 
* @param hql Hibernate 查询 语句 
* @param pn 页 码 从 1 开始 ， 
* @param pageSize 每 页 记录 数 
* @param paramlist 可 变 参 数列 表 
* @return 模型 对 象 列 表 
A 
@Suppresswarnings("unchecked") 
protected <T> List<T> list(final String hql, final int pn, final int pageSize, final 0 
return getHibernateTemplate(). 
executeFind(new HibernateCallback<List<T>>() { 
public List<T> doInHibernate(Session session) throws HibernateException, SQL 
Query query = session.createQuery(hql); 
if (paramlist != nul1) { 
for (int i = 0; i < paramlist.length; i++) { 
query.setPparameter(i,，paramlist[i]);// 设 置 占 位 符 参数 
} 
} 


if (pn > -1 && pageSize > -1) {// 分 页 处 理 
query.setMaxResults(pageSize);// 设 置 将 获取 的 最 大 记录 数 
int start = PageUtil.getPageStart(pn, pageSize); 
if(start != 0) { 

query.setFirstResult(start);// 设 置 记录 开始 位 置 
} 


} 
return query.1ist(); 
} 
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} 
/** 根据 查询 条 件 返回 唯一 一 条 记录 
* @param <T> 返回 类 型 
* @param hql Hibernate 查 询 语 名 
* @param paramlist 参数 列表 
* @return 返回 唯一 记录 */ 
@Suppresswarnings("unchecked") 
protected <T> T unique(final String hql, final Object... paramlist) { 
return getHibernateTemplate().execute(new Hibernatecallback<T>() { 
public T doInHibernate(Session session) throws HibernateException, SQLExcepti 
Query query = session.createQuery(hql); 
if (paramlist != null) { 
for (int i = 0; i < paramlist.length; i++) { 
query.setParameter(i, paramlist[i]); 
} 


} 
return (T) query.setMaxResults(1).uniqueResult(); 


} 
}); 


} 
// 省 略 部 分 可 选 的 便利 方法 ， 想 了 解 更 多 请 参考 源 代码 





通用 DAO 实 现代 码 相 当 长 ， 但 麻烦 一 次 ， 以 后 有 了 这 套 通 用 代码 将 会 让 工作 很 轻松 ， 该 通用 
DAO 还 有 其 他 便利 方法 因为 本 示例 不 需要 且 由 于 篇 幅 原 因 没 加 上 ， 请 参考 源 代码 。 


11.2.4 通用 业务 逻辑 层 


目标 


实现 通用 的 业务 逻辑 操作 ， 将 常用 操作 封装 提高 复 用 ， 可 变 部 分 同样 按 需 实现 。 


通用 业务 逻辑 层 接口 定义 


package cn 


.Javass.commons.service; 


// 由 于 篇 幅 问 题 省 略 ijmport 
public interface IBaseService<M extends Serializable, PK extends Serializable> { 


public M save(M model); // 保 存 模型 对 象 

public void saveOrUpdate(M model);// 保存 或 更 新 模型 对 象 

public void update(M model);// 更 新 模型 对 象 

public void merge(M model);// 合并 模型 对 象 状 态 

public void delete(PK id);// 删除 模型 对 象 

public M get(PK id);// 根据 主键 获取 模型 对 象 

public int countA11() ;// 统 计 模 型 对 象 对 应 数据 库 表 中 的 记录 数 

public List<M> 1ListAL1();// 获 取 所 有 模型 对 象 

public Page<M> listAll(int pn);// 分 页 获取 默认 分 页 大 小 的 所 有 模型 对 象 

public Page<M> listAll(int pn，int pageSize);// 分 页 获取 所 有 模型 对 象 

} 

通用 业务 逻辑 层 接 口 实现 
通用 业务 逻辑 层 通 过 将 通用 的 持久 化 操作 委托 给 DAO 层 来 实现 通用 的 数据 模型 CRUD 等 操 
作 。 


通过 通用 的 SetDao 方 法 注入 通用 DAO 实 现 ， 在 各 Service 实 现时 可 以 通过 强制 转型 获取 各 转型 


后 的 DAO。 


package cn.javass.commons.service.impl; 
// 由 于 篇 幅 问题 省 略 import 
public abstract class BaseServiceImpl<M extends Serializable, PK extends Serializable> im 
protected IBaseDao<M, PK> dao; 
public void setDao(IBaseDao<M，PK> dao) {// 需 要 依赖 注入 
this.dao = dao; 


public IBaseDao<M, PK> getDao() { 
return this.dao; 


public M save(M model) { 
getDao().save(model); 
return model; 


public void merge(M model) { 
getDao().merge(model); 


public void saveOrUpdate(M model) { 
getDao().saveOrUpdate(model); 


public void update(M model) { 
getDao().update(model); 


} 
public void delete(PK id) { 
getDao().delete(id); 


public void deleteObject(M model) { 
getDao().deleteObject(model); 


} 
public M get(PK id) { 
return getDao().get(id); 


} 
public int countAll() { 
return getDao().countAll(); 


} 
public List<M> listAl1l() { 
return getDao().1istAll(); 


public Page<M> listAll(int pn) { 
return this.1listAll(pn, Constants.DEFAULT_PAGE_SIZE); 


public Page<M> listAll(int pn, int pageSize) { 
Integer count = countAll(); 
List<M> items = getDao().1listAll(pn, pageSize); 
return PageUtil.getPpage(count, pn, items, pageSize); 





11.2.6 通 用 表现 层 


目标 : 规约 化 常见 请 求 和 响应 操作 ， 将 常见 的 CURD 规 约 化 ， 采 用 规约 编程 提供 开发 效 举 ， 减 
少 重 复 劳 动 。 


Struts2 常 见 规约 编程 : 


e。 通用 字段 驱动 注入 : 如 分 页 字段 一 般 使 用 “pn” 或 “page” 来 指定 当前 分 页 页 码 参 数 名 ， 通 过 
Struts2 的 字段 驱动 注入 实现 分 页 页 码 获取 的 通用 化 ; 

e。 通用 Result : 对 于 CURD 操 作 完 全 可 以 提取 公共 的 Result 名 字 ， 然 后 在 Strust2 配 置 文件 
中 进行 规约 配置 ; 

e。 数据 模型 属性 名 : 在 页 面 展示 中 ， 如 新 增 和 修改 需要 向 值 栈 或 请 求 中 设置 数据 模型 ， 在 


此 我 们 定义 统一 的 数据 模型 名 如 “model"， 这 样 在 项 目 组 中 形成 约定 ， 大 家 只 要 按 有 
来 能 提高 开发 效率 ; 

e 分 页 对 象 属性 名 : 与 数据 模型 属性 名 同 理 ， 在 此 我 们 指定 为 "page” 

e 便利 方法 : 如 获取 值 栈 、 请 求 等 可 以 提供 公司 内 部 需要 的 便利 方法 。 


2 


约定 


用 表现 层 Action 实 现 : 


package cn.javass.commons .web.action; 
import cn.javass.commons.Constants; 
// 省 略 import 
public class BaseAction extends ActionSupport { 
/** 通用 Result */ 
public static final String LIST = "list",; 
public static final String REDIRECT = "redirect"; 
public static final String ADD = "add"; 
/** 模型 对 象 属 性 名 */ 
public static final String MODEL = "model"; 
/** 列表 模型 对 象 属 性 名 */ 
public static final String PAGE = Constants.DEFAULT_PAGE_NAME， 
public static final int DEFAULT_PAGE_SIZE = Constants.DEFAULT_PAGE_ SIZE; 
private int pn = 1; /** 页 码 ， 默 认为 1 */ 
// 省 略 pn 的 getter 和 Setter， 自 己 补 上 
public ActionContext getActionContext() { 
return ActionContext.getContext(); 


} 

public ValueStack getValueStack() {// 获 取 值 栈 的 便利 方法 
return getActionContext().getValueSstack(); 

} 


通用 表现 层 JSP 视 图 实现 : 
将 视图 展示 的 通用 部 分 抽象 出 来 减少 页 面 设 计 的 工作 量 。 
2.1、 通 用 JSP 页 头 文件 (WEB-INF/jsp/common/inc/headerjsp ) 


此 处 实现 比较 简单 ， 实 际 中 可 能 菜单 等 信息 ， 对 于 可 变 部 分 使 用 请 求 参数 来 获取 ， 从 
而 保证 了 可 变 与 不 可 变 分 离 ee 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<!DOCTYPE html] PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN™" "http://www.w3.org/TR/html 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 
<title>${param.title}</title> 
</head> 
<body> 


ME 





2.2、 通 用 JSP 页 尾 文 件 (WEB-INF/jsp/common/inc/footer.jsp) 


此 处 比较 简单 ， 实 际 中 可 能 包含 公司 版 权 等 信息 。 


</body> 
</html> 


2.3、 通 用 JSP 标 签 定义 文件 (WEB.-INF/jsp/common/incltld.jsp) 


在 一 处 定义 所 有 标签 ， 避 免 标 签 定 义 使 代码 变 得 凌乱 ， 且 如 果 有 多 个 页 面 需要 新 增 或 删除 标 
签 即 费事 又 费力 。 


<%@taglib prefix="c" uri="http://java.sun.com/jstl/core" %> 
<%@taglib prefix="s" uri="/struts-tags" % 


2.4、 通 用 错误 JSP 文 件 (WEB-INF/jsp/common/error.jsp) 


当 系 统 遇 到 错误 或 异常 时 应 该 跳 到 该 页 面 来 显示 统一 的 错误 信息 并 可 能 在 该 页 保存 异常 信 
自 。 


心 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<jsp:include page="inc/header.jsp"/> 

失败 或 遇 到 异常 ! 

<jsp:include page="inc/footer.jsp"/> 


2.5、 通 用 正确 JSP 文 件 (WEB-INF/jsp/common/success.jsp) 


对 于 执行 成 功 的 操作 可 以 使 用 通用 的 页 面 表 示 ， 可 变 部 分 同样 可 以 使 用 可 变 的 请 求 参数 传 
入 o 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<jsp:include page="inc/header.jsp"/> 

成 功 ! 

<jsp:include page="inc/footer.jsp"/> 


3、 通 用 设置 Web 环 境 上 下 文 路 径 拦 截 器 : 


用 于 设置 当前 web 项 目的 上 下 文 路 径 ， 即 可 以 在 JSP 页 面 使 用 '${ctx}” 获 取 当 前 上 下 文 路 径 。 


package cn.javass.commons.web.filter; 
// 省 略 import 
/** 用 户 设 置 当前 Web 环境 上 下 文 ， 用 于 方便 如 JSP 页 面 使 用 */ 
public class ContextPathFilter implements Filter { 
@Override 
public void init(FilterConfig config) throws ServletException { 
} 
@Override 
public void doFilter( 
ServiletRequest request, ServletResponse response, FilterChain chain) 
throws IOException, ServletException { 
String contextPath = ((HttpServletRequest) request ) .getContextPath( ) ; 
request .setAttribute(Constants,. CONTEXT_PATH， contextPath ) ; 
chain.doFilter(request, response); 
} 
@Override 
public void destroy() { 


} 


11.2.7 通 用 配置 文件 


目标 : 通用 化 某 些 常用 且 不 可 变 的 配置 文件 ， 同 样 目 标 是 提高 复 用 ， 减 少 工作 量 。 
1、Spring 资 源 配 置 文件 《resources/applicationContext-resources.xml ) 


定义 如 配置 元 数据 替换 Bean、 数 据 源 Bean 等 通用 的 Bean。 


<bean class= 
"org.springframework.beans.factory.config.PropertyPlaceholderConfigurer"> 
<property name="locations"> 
<list> 
<value>classpath:resources.properties</value> 
</list> 
</property> 
</bean> 
<bean id="dataSource" class="org.springframework.jdbc.datasource.LazyConnectionDataSo 
<property name="targetDataSource"> 
<bean class="org.logicalcobwebs.proxool.ProxoolDataSource"> 
<property name="driver" value="${db.driver.class}" /> 
<property name="driverUrl" value="${db.url}" /> 
<property name="user" value="${db.username}" /> 
<property name="password" value="${db.password}" /> 
<property name="maximumConnectionCount" value="${proxool.maxConnCount}" / 
<property name="minimumConnectionCount" value="${proxool.minConnCount}" / 
<property name="statistics" value="${proxool.statistics}" /> 
<property name="simultaneousBuildThrottle" value="${proxool.simultaneousB 
<property name="trace" value="${proxool.trace}" /> 
</bean> 
</property> 
</bean> 
</beans> 


国 一 一 一 二 


te ne 的 如 数据 库 驱 动 、URL、 用 户 名 等 采用 替换 配置 元 
具体 配置 含义 请 参考 【7.5 集 成 Spring JDBC 及 最 佳 实践 】。 





2、 和 替换 配置 元 数据 的 资源 文件 (resources/resources.properties) 


定义 替换 配置 元 数据 键 值 对 用 于 替换 Spring 配置 文件 中 可 变 的 配置 元 数据 。 


# 数 据 库 连接 池 属 性 

proxool.maxConnCount=10 

proxool.minConnCount=5 

proxool.statistics=1im,15m,1h,1d 

proxool.simultaneousBuildThrottle=30 

proxool.trace=false 

db.driver.class=com.mysql.jdbc.Driver 
db.url=jdbc:mysql://localhost:3306/point_shop?useUnicode=true&characterEncoding=utf8 
db.username=root 

db .password= 


通用 Struts2 配 置 文件 (WEB-INF/struts.Xxml ) 


由 于 是 要 集成 Spring， 因 此 需要 使 用 StrutsSpringObjectFactory， 我 们 需要 在 action 名 字 中 出 
现 “/" 因 此 定义 struts.enable.SlasheslnActionNames=true。 


在 此 还 定义 了 “custom-default* 包 继承 struts-default 包 ， 且 是 抽象 的 ， 在 包 里 定义 了 如 全 局 结 
果 集 全 局 异常 映射 。 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE struts PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" 
"http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts> 
<constant name="struts.objectFactory" value="org.apache.struts2.spring.StrutsSpringOb 
<1-- 允许 action 的 名 字 中 出 现 "/" --> 
<constant name="struts.enable.SlashesInActionNames" value="true"/> 
<package name="custom-default" extends="struts-default" abstract="true"> 
<global-results> 
<result name="success">/WEB-INF/jsp/common/success.jsp</result> 
<result name="error">/WEB-INF/jsp/common/error.jsp</result> 
<result name="exception">/WEB-INF/jsp/common/error.jsp</result> 
</global-results> 
<global-exception-mappings> 
<exception-mapping result="exception" exception="java.lang.Exception"/> 
</global-exception-mappings> 
</package> 
</struts> 


| 


4、 通 用 log4j 日 志 记 录 配 置 文件 (resources/log4j.xml) 





可 以 配置 基本 的 log4j 配 置 文件 然后 在 其 他 地 方 通过 拷贝 来 定制 需要 的 日 志 记录 配置 。 


<?xml1 version="1.0" encoding="UTF-8"?> 
<!DOCTYPE 1og4j:configuration SYSTEM "10g4j .dtd"> 
<1o0g4j :configuration xmlns:10g4j="http://jakarta.apache.org/10g4j/"> 
<!-- Appenders --> 
<appender name="console" class="org.apache.10g4]j.ConsoleAppender"> 
<param name="Target" value="System.out" /> 
<layout class="org.apache.1og4j.PatternLayout"> 
<param name="ConversionPattern" value="%-5p: %c - %m%n" /> 


</layout> 
</appender> 
<!-- Root Logger --> 


<root> 
<priority value="DEBUG" /> 
<appender-ref ref="console" /> 
</root> 
</10g4j :configuration> 


4、 通 用 web.xml 配 置 文件 定义 (WEB-INF/web.xml) 


定义 如 通用 的 集成 配置 、 设 置 Web 环 境 上 下 文 过 滤器 、 字 符 过 滤器 (防止 乱码 ) 、 通 用 的 
Web 框 架 拦截 器 (如 Struts2 的 ) 等 等 ， 从 而 可 以 通过 拷贝 复 用 。 


<?xml1 version="1.0" encoding="UTF-8"?> 
<web-app id="WebApp_ID" version="2.5" xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instanc 
<!-- 通用 配置 开始 > 
<context-param> 
<param-name>contextCconfigLocation</param-name> 
<param-value> 
classpath:applicationContext-resources.xml 
</param-value> 
</context-param> 
<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 


</listener> 

<1-- 通用 配置 结束 SS 

<1-- 设置 web 环境 上 下 文 (方便 JSP 页 面 获取 ) 开始  --> 
<filter> 


<filter-name>Set Context Path</filter-name> 
<filter-class>cn.javass.commons.web.filter.ContextPpathFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>Set Context Path</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<1-- 设置 web 环境 上 下 文 (方便 JSP 页 面 获取 ) 结 > 
<1-- 字符 编码 过 滤器 (防止 乱码 ) 开始  --> 
<filter> 


<filter-name>Set Character Encoding</filter-name> 
<filter-class> 
org.springframework .web.filter.CharacterEncodingFilter 
</filter-class> 
<init-param> 
<param-name>encoding</param-name> 
<param-value>UTF-8</param-value> 
</init-param> 
<init-param> 
<param-name>forceEncoding</param-name> 
<param-value>true</param-value> 
</init-param> 
</filter> 
<filter-mapping> 
<filter-name>Set Character Encoding</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


<1-- 字符 编码 过 滤器 (防止 乱码 ) 结束  --> 
<!-- Struts2.x 前 端 控制 器 配置 开始  --> 
<filter> 


<filter-name>struts2Filter</filter-name> 
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> 
</filter> 


<filter-mapping> 
<filter-name>struts2Filter</filter-name> 
<url-pattern>*.action</url-pattern> 
</filter-mapping> 
<!-- Struts2.X 前 端 控制 器 配置 结束 。 --> 
</web -app> 


是 一 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/2515.html]】 
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【第 十 一 章 】 SSH 集 成 开发 积分 商城 之 11.3 实 实现 


、 


积分 商城 层 一 一 跟 我 学 spring3 


11.3 实现 积分 商城 层 


11.3.1 概述 


Ce 通用 层 之 上 进行 开发 ， 这 样 我 们 能 减少 很 多 重复 的 劳动 ， 加 快 项 目 开 发 进 


O 


er 


11.3.2 实现 数据 模型 层 


1、 商 品 表 ， 定 义 了 如 商品 名 称 、 简 介 、 原 需 积分 、 现 需 积 分 等 ， 其 中 是 否 发 布 表 示 只 有 发 布 
(true) 了 的 商品 才 会 在 前 台 删 除 ， 是 否 已 删 B 二 不 会 物理 删除 ， 商 品 不 应 该 物理 删除 ， 而 
是 逻辑 删除 ， 版 本 属性 用 于 防止 并 发 更 新 。 


package cn.javass.point.model; 
/** 商品 表 */ 
@Entity 
@Table(name = "tb_goods") 
public class GoodsModel implements java.io.Serializable { 
a 
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) 
@Column(name = "id", length = 10) 
private int id; 
/xx 商品 名 称 */ 
@Column(name = "name", nullable = false, length = 100) 
private String name; 
/** 商品 简介 */ 
@Column(name = "description", nullable = false, length = 100) 
private String description; 
/** 原 需 积分 */ 
@Column(name = "original point", nullable = false, length = 10) 
private int originalPoint; 
le 
@Column(name = "now_ point", nullable = false, length = 10) 
private int nowPoint; 
/** 是 否 发 布 ， 只 有 发 布 的 在 前 合 显示 */ 
@Column(name = "published", nullable = false) 
private boolean published; 
/** 是 否 删 除 ， 商 品 不 会 被 物理 删除 的 */ 


@Column(name = "is_delete", nullable = false) 

private boolean deleted; 

Dre 

@Version @Column(name = "version", nullable = false, length = 10) 


private int version; 
// 省 略 getter 和 setter、hashCode 及 equals， 实 现 请 参考 源 代码 


2、 商 品 兑换 码 表 ， 定 义 了 兑换 码 、 兑 换 码 所 属 商品 (兑换 码 和 商品 直接 是 多 对 一 关系 ) 、 购 
买 人 、 购 买 时 间 、 是 否 已 经 购买 (防止 一 个 兑换 码 多 个 用 户 兑 换 ) 、 版 本 。 


package cn.javass.point.model; 

Import java.util.Date; 

// 省 略 部 分 import 

/** 商品 兑换 码 表 */ 

@Entity 

@Table(name = "tb_goods _ code") 

public class GoodsCodeModel implements java.io.Serializable { 
/A 
@Id @GeneratedValue(strategy = GenerationType.IDENTITY) 
@Column(name = "id", length = 10) 
private int id; 
/** 所 属 商品 */ 
@ManyToOne 
private GoodsModel goods; 
/xx 竞 换 码 */ 
@Column(name = "code", nullable = false, length = 100) 
private String code; 
/** 兑换 人 ,实际 环境 中 应 该 和 用 户 表 进 行 对 应 */ 
@Column(name = "username", nullable = true, length = 100) 
private String username; 


/** 兑换 时 间 */ 

@Column(name = "exchange_time") 
private Date exchangeTime; 

/xx 是 否 已 经 沈 换 */ 


@Column(name = "exchanged") 

private boolean exchanged = false; 

Wy 

@Version 

@Column(name = "version", nullable = false, length = 10) 


private int version; 
// 省 略 getter 和 setter、hashCode 及 equals， 实 现 请 参考 源 代码 


3、 商 品 表 及 商品 兑换 码 表 之 间 关 系 ， 即 一 个 商品 有 多 个 兑换 码 ， 如 图 11-10 所 示 : 


兑换 时 间 
是 否 已 经 兑换 
版 本 





图 11-10 商 品 表 及 商品 兑换 码 表 之 间 关 系 


4、 创建 数据 库 及 表 结 构 的 SQL 语 句 文件 (sql/ pointShop_schema.sql) 


CREATE DATABASE IF NOT EXISTS “point_shop. 
DEFAULT CHARACTER SET "utf8 ' ; 

USE “point_shop ， 

DROP TABLE IF EXISTS ‘tb goods code'; 
DROP TABLE IF EXISTS "tb_goods ， 


CREATE TABLE ‘tb goods ( 


`id” int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT ' 商 品 id'， 
“name `” varchar(100) NOT NULL COMMENT ' 商 品名 称 '， 
“description” varchar(100) NOT NULL COMMENT ' 商 品 简介 


“original point”int(10) unsigned NOT NULL COMMENT ' 原 需 积 分 '， 
“now_point ”jnt(10) unsigned NOT NULL COMMENT ' 现 需 积分 '， 
“published” bool NOT NULL COMMENT ' 是 否 发 布 '， 

`is_delete” bool NOT NULL DEFAULT false COMMENT ' 是 否 删 除 '， 
“version” int(10) unsigned NOT NULL DEFAULT 9 COMMENT ' 版 本 '， 
PRIMARY KEY (~id:), 

INDEX( name ), 

INDEX( published ) 

)ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT=' 商品 表 ' ; 


CREATE TABLE “tb_goods_code ( 


`id ”int(10) unsigned NOT NULL AUTO_INCREMENT COMMENT ' 主 键 id'， 

“username ”varchar(100) COMMENT “兑换 用 户 '， 

“goods_id” jint(10) unsigned NOT NULL COMMENT “' 所 属 商品 id'， 

“code” varchar(100) NOT NULL COMMENT ' 积 分 '， 

“exchange_ time. datetime COMMENT ' 购 买 时 间 '， 

`exchanged ”bool DEFAULT false COMMENT ' 是 否 已 经 兑换 '， 

“version” int(10) unsigned NOT NULL DEFAULT 9 COMMENT ' 版 本 '， 

PRIMARY KEY (`id`)， 

FOREIGN KEY (goods id ) REFERENCES ‘tb_goods (id) ON DELETE CASCADE 
)ENGINE=InnoDB AUTO_INCREMENT=1000000 DEFAULT CHARSET=utf8 COMMENT=' 商品 兑换 码 表 ' ， 


Mysql 数 据 库 引 擎 应 该 使 用 InnoDB， 如 果 使 用 MyISM 将 不 支持 事务 。 


11.3.3 实现 数据 访问 层 


数据 访问 层 只 涉及 与 底层 数据 库 或 文件 系统 等 打交道 ， 不 会 涉及 业务 逻辑 ， 一 定 注 意 层 次 边 
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不 要 在 数据 访问 层 实现 业务 逻辑 。 


商品 模块 的 应 该 实现 如 下 功能 : 


继承 通用 数据 访问 层 的 CRUD 功 能 ; 
分 页 查询 所 有 已 发 布 的 商品 
统计 所 有 已 发 布 的 商品 ; 


商品 兑换 码 模块 的 应 该 实现 如 下 功能 : 


继承 通用 数据 访问 层 的 CRUD 功 能 ; 
根据 商品 ID 分 页 查询 该 商品 的 兑换 码 

根据 商品 ID 统计 该 商品 的 兑换 码 记录 数 ; 
根据 商品 ID 获 取 一 个 还 没有 兑换 的 商品 兑换 码 


1、 商 品 及 商品 兑换 码 DAO 接 口 定 义 : 


商品 及 商品 兑换 码 DAO 接 口 定 义 直接 继承 IBaseDao， 无 需 在 这 些 接口 中 定义 重复 的 CRUD 方 
法 了 ， 并 通过 泛 型 指定 数据 模型 类 及 主键 类 型 。 


package cn.javass.point.dao; 
// 省 略 import 
/** 商品 模型 对 象 的 DAO 接 口 */ 
public interface IGoodsDao extends IBaseDao<GoodsModel, Integer> { 
/** 分 页 查询 所 有 已 发 布 的 商品 */ 
List<GoodsModel> listAllpPublished(int pn); 
/xx 统计 所 有 已 发 布 的 商品 记录 数 */ 
int countAllPublished( ); 


package cn.javass.point.dao; 
// 省 略 import 
/** 商品 兑换 码 模 型 对 象 的 DA0 接 口 */ 
public interface IGoodsCodeDao extends IBaseDao<GoodsCodeModel, Integer> { 
/** 根据 商品 ID 统 计 该 商品 的 兑换 码 记录 数 */ 
public int countAllByGoods(int goodsId); 
/** 根据 商品 ID 查询 该 商品 的 兑换 码 列 表 */ 
public List<GoodsCodeModel> listAllByGoods(int pn, int goodsId ) ; 
/** 根据 商品 ID 获 取 一 个 还 没有 兑换 的 商品 涡 换 码 */ 
public GoodsCodeModel getOneNotExchanged(int goodsId); 


2、 商品 及 商品 兑换 码 DAO 接 口 实现 定义 : 


DAO 接 口 实现 定义 都 非常 简单 ， 对 于 CRUD 实 现 直接 从 BaseHibernateDao 继 承 即 可 ， 无 需 再 
定义 重复 的 CRUD 实 现 了 ， 并 通过 泛 型 指定 数据 模型 类 及 主键 类 型 。 


package cn.javass.point.dao.hibernate; 
// 省 略 import 
public class GoodsHibernateDao extends BaseHibernateDao<GoodsModel, Integer> implements I 
@Override // 窗 盖 掉 父 类 的 delete 方 法 ， 不 进行 物理 删除 
public void delete(Integer id) { 
GoodsModel goods = get(id); 
goods.setDeleted(true); 
update(goods); 


} 
@Override // 履 盖 掉 父 类 的 getCountAL1LHq1 方 法 ， 查 询 不 包括 逻辑 删除 的 记录 
protected String getCountAllHq1l() { 

return super.getCountAllHq1l() + " where deleted=false"; 


} 
@override // 履 盖 掉 父 类 的 getListA1L1LHqd1 方 法 ， 查 询 不 包括 逻辑 删除 的 记录 
protected String getListAllHq1l() { 
return super.getListAllHq1l() + " where deleted=false"; 
} 


@override // 统 计 没有 被 逻辑 删除 的 且 发 布 的 商品 数量 
public int countAllPublished() { 
String hql = getCountAllHq1l() + " and published=true"; 
Number result = unique(hql); 
return result.intValue(); 
} 
@Override // 查 询 没 有 被 逻辑 删除 的 且 发 布 的 商品 
public List<GoodsModel> listAllPublished(int pn) { 
String hql = getListAllHql() + " and published=true"; 
return list(hql, pn, Constants.DEFAULT_PAGE_SIZE); 








package cn.javass.point.dao.hibernate; 

// 省 略 import 

public class GoodsCodeHibernateDao extends 

BaseHibernateDao<GoodsCodeModel, Integer> implements IGoodsCodeDao { 

@override  // 根 据 商 品 ID 查 询 该 商品 的 兑换 码 

public List<GoodsCodeModel> listAllByGoods(int pn, int goodsId) { 

final String hql = getListAllHq1l() + " where goods.id = ?"; 
return list(hql, pn, Constants.DEFAULT_ PAGE_ SIZE , goodsId); 


} 
@override // 根 据 商品 ID 统计 该 商品 的 兑换 码 数 量 
public int countAllByGoods(int goodsId) { 
final String hql = getCountAllHq1l() + " where goods.id = ?"; 
Number result = unique(hql, goodsId); 
return result.intValue(); 


3、Spring DAO 层 配置 文件 (resources/cn/javass/point/dao/ applicationContext- 
hibernate.xml) 


DAO 配 置 文件 中 定义 Hibernate 的 SessionFactory、 事 务 管理 器 和 DAO 实 现 。 


<bean id="sessionFactory" class="org.springframework.orm.hibernate3.annotation.Annotation 


<property name="dataSource" ref="dataSource"/><!-- 1、 指 定数 据 源 --> 
<property name="annotatedClasses"> <1-- 2、 指 定 注 解 类 --> 
<list> 


<value>cn.javass.point.model.GoodsModel</value> 
<value>cn.javass.point.model.GoodsCodeModel</value> 
</list> 
</property> 
<property name="hibernateProperties"><!-- 3、 指 定 HIibernate 属 性 --> 
<props> 
<prop key="hibernate.dialect">${hibernate.dialect}</prop> 
<prop key="hibernate.show_ sql">${hibernate.show_ sql}</prop> 
<prop key="hibernate.format_sql">${hibernate.format_sql}</prop> 
<prop key="hibernate.hbm2ddl.auto">${hibernate.hbm2dd1.auto}</prop> 
</props> 
</property> 
</bean> 
<bean id="txManager" class="org.springframework.orm.hibernate3.HibernateTransactionManage 
<property name="sessionFactory" ref="sessionFactory"/> 
</bean> 


HE 





<bean id="abstractDao" abstract="true" init-method="init"> 
<property name="sessionFactory" ref="sessionFactory"/> 
</bean> 
<bean id="goodsDao" class="cn.javass.point.dao.hibernate.GoodsHibernateDao" parent="abstr 
<bean id="goodsCodeDao" class="cn.javass.point.dao.hibernate.GoodsCodeHibernateDao" paren 


了 一 





4、 修 改 替换 配置 元 数据 的 资源 文件 (resources/resources.properties ) ， 添 加 Hibernate 
属性 相关 : 


#Hibernate 属 性 

hibernate.dialect=org.hibernate ,dialect.MySQL5InnoDBDiIalect 
hibernate.hbm2ddl,auto=none 

hibernate. show_sql=false 

hibernate.format_sql=true 


11.3.4 实现 业务 逻辑 层 


业务 逻辑 层 实现 业务 逻辑 ， 即 系统 中 最 复杂 、 最 核心 的 功能 ， 不 应 该 在 业务 逻辑 层 出 现 如 数 
据 库 访问 等 底层 代码 ， 对 于 这 些 操作 应 委托 给 数据 访问 层 实现 ， 从 而 保证 业务 逻辑 层 的 独立 
性 和 可 复 用 性 ， 并 应 该 在 业务 逻辑 层 组 装 分 页 对 象 。 


商品 模块 应 该 实现 如 下 功能 : 


e。 CURD 操 作 ， 直 接 委 托 给 通用 业务 逻辑 层 ; 
e 根据 页 码 查询 所 有 已 发 布 的 商品 的 分 页 对 象 ， 即 查询 指定 页 的 记录 ， 这 是 和 数据 访问 层 
不 同 的 ; 


商品 兑换 码 模块 应 该 实现 如 下 功能 : 


。 CURD 操 作 ， 直 接 委 托 给 通用 业务 逻辑 层 ; 

。 根据 页 码 和 商品 ld 查询 查询 所 有 商品 兑换 码 分 页 对 象 ， 即 查询 指定 页 的 记录 ; 

e。 新 增 指定 商品 的 兑换 码 ， 用 于 对 指定 商品 添加 兑换 码 ; 

e 购买 指定 商品 兑换 码 操 作 ， 用 户 根 据 商 品 购买 该 商品 的 兑换 码 ， 如 果 指 定 商品 的 兑换 码 
没有 了 将 抛 出 没有 兑换 码 异 常 NotCodeException ; 


1、 商 品 及 商品 兑换 码 Service 接 口 定义 : 


接口 定义 时 ， 对 于 CRUD 直 接 继 承 IBaseService 即 可 ， 无 需 再 在 这 些 接口 中 定义 重复 的 CRUD 
方法 了 ， 并 通过 泛 型 指定 数据 模型 类 及 数据 模型 的 主键 。 


package cn.javass.point.service,; 

// 省 略 import 

public interface IGoodsService extends IBaseService<GoodsModel, Integer> { 
/** 根 据 页 码 查询 所 有 已 发 布 的 商品 的 分 页 对 象 */ 
Page<GoodsModel> listAllPublished(int pn); 


package cn.javass.point.service,; 
// 省 略 import 
public interface IGoodsCodeService extends IBaseService<GoodsCodeModel], Integer> { 
/** 根据 页 码 和 商品 Id 查询 查询 所 有 商品 兑换 码 分 页 对 象 */ 
public Page<GoodsCodeModel> listAllByGoods(int pn, int goodsId); 
/** 新 增 指 定 商品 的 兑换 码 */ 
public void save(int goodsId，String[] codes); 
/** 购买 指定 商品 兑换 码 */ 
GoodsCodeModel buy(String username, int goodsId) throws NotCodeException ， 


2、NotCodeException 异 常 定义 ， 表 示 指 定 商 品 的 兑换 码 已 经 全 部 被 兑换 了 ， 没 有 剩余 的 竞 
换 码 了 : 


package cn.javass.point.exception; 
/** 购买 失败 异常 ， 表 示 没 有 足够 的 兑换 码 */ 
public class NotCodeException extends RuntimeException { 


} 


NotCodeException 措 常 类 实现 RuntimeException， 当 需要 更 多 信息 时 可 以 在 异常 中 定义 ， 异 
常 比 硬 编码 错误 代码 (如 -1 表示 没有 足够 的 兑换 码 ) 更 好 理解 。 


3、 商 品 及 商品 兑换 码 Service 接 口 实现 定义 : 


接口 实现 时 ，CRUD 实 现 直接 从 BaseServcice 继 承 即 可 ， 无 需 再 在 这 些 专 有 实现 中 定义 重复 
的 CRUD 实 现 了 ， 并 通过 泛 型 指定 数据 模型 类 及 数据 模型 的 主键 。 


package cn.javass.point.service.impl; 
// 省 略 import 
public class GoodsServiceImpl extends BaseServiceImpl<GoodsModel, Integer> implements IGo 
@Override 
public Page<GoodsModel> listAllPublished(int pn) { 
int count = getGoodsDao().countAllPublished(); 
List<GoodsModel> items = getGoodsDao().1listAllPublished(pn); 
return PageUtil.getPpage(count, pn, items, Constants.DEFAULT_PAGE_ SIZE); 


} 
IGoodsDao getGoodsDao() {// 将 通用 DAO 转 型 


return (IGoodsDao) getDao(); 





package cn.javass.point.service.impl; 
// 省 略 import 
public class GoodsCodeServiceImpl extends BaseServiceImpl<GoodsCodeModel, Integer> implem 
private IGoodsService goodsService; 
public void setGoodsService(IGoodsService goodsService) {// 注 入 IGoodsService 
this.goodsService = goodsService; 


private IGoodsCodeDao getGoodsCodeDao() {// 将 注入 的 通用 DAO 转 型 
return (IGoodsCodeDao) getDao(); 


Q@Override 
public Page<GoodsCodeModel> listAllByGoods(int pn, int goodsId) { 
Integer count = getGoodsCodeDao().countAllByGoods(goodsId); 
List<GoodsCodeModel> items = getGoodsCodeDao().1listAllByGoods(pn, goodsId); 
return PageUtil.getPpage(count, pn, items, Constants.DEFAULT_PAGE_ SIZE); 
} 
Q@override 
public void save(int goodsId，String[] codes) { 
GoodsModel goods = goodsService.get(goodsId); 
for(String code : codes) { 
if(StringUtils.hasText(code)) { 
GoodsCodeModel goodscode = new GoodsCodeModel(); 
goodsCode.setCode(code); 
goodsCode. setGoods(goods); 
save(goodsCode); 


} 
} 
} 
Q@Override 
public GoodsCodeModel buy(String username, int goodsId) throws NotCodeException { 
//1、 实 际 实现 时 要 验证 用 户 积分 是 否 充 足 
//2、 其 他 逻辑 判断 
//3、 实 际 实现 时 要 记录 交易 记录 开始 
GoodsCodeModel goodsCode = getGoodsCodeDao().getoneNotExchanged(goodsId); 


if(goodsCode == null) { 
//3、 实 际 实现 时 要 记录 交易 记录 失败 
throw new NotCodeException(); 
// 目 前 只 抛 出 一 个 异常 ， 还 可 能 比如 并 发 购买 情况 


goodsCcode .setExchanged(true) 
goodsCode.setExchangeTime(new Date()); 
goodsCode.setUsername(username); 
save(goodsCode); 

//3、 实 际 实现 时 要 记录 交易 记录 成 功 

return goodsCode; 





save 方 法 和 buy 方 法 实现 并 不 是 最 优 的 ，save 方 法 中 如 果 兑 换 码 有 上 千 个 怎么 办 ?3 这 时 就 需要 
批 处 理 了 ， 通 过 批 处 理 比 如 20 条 一 提交 数据 库 来 提高 性 能 。buy 方 法 就 要 考虑 多 个 用 户 同 时 购 
买 同一 个 兑换 码 如 何 处 理 ? 


交易 历史 一 定 要 记录 ， 从 交易 开始 到 交易 结束 (不管 成 功 与 否 ) 一 定 要 记录 用 于 当 客户 投诉 
时 查询 相应 数据 。 


4、Spring Service 层 配置 文件 (resources/cn/javass/point/service/ applicationContext- 
service.xml) 


Service 层 配置 文件 定义 了 事务 和 Service 实 现 。 


<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<tx:method name="save*" propagation="REQUIRED" /> 
<tx:method name="add*" propagation="REQUIRED" /> 
<tx:method name="create*" propagation="REQUIRED" /> 
<tx:method name="insert*" propagation="REQUIRED" /> 
<tx:method name="update*" propagation="REQUIRED" /> 
<tx:method name="del*" propagation="REQUIRED" /> 
<tx:method name="remove*" propagation="REQUIRED" /> 
<tx:method name="buy*" propagation="REQUIRED" /> 
<tx:method name="count*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="find*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="list*" propagation="SUPPORTS" read-only="true" /> 
<tx:method name="*" propagation="SUPPORTS" read-only="true" /> 
</tx:attributes> 
</tx:advice> 


<aop:config> 
<aop:pointcut id="txPointcut" expression="execution(* cn.javass.point.service.*.*(..) 
<aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut" /> 

</aop:config> 

<bean id="goodsService" class="cn.javass.point.service.impl.GoodsServiceImpl"> 
<property name="dao" ref="goodsDao"/> 

</bean> 

<bean id="goodsCodeService" class="cn.javass.point.service.impl.GoodsCodeServiceImpl"> 
<property name="dao" ref="goodsCodeDao"/> 
<property name="goodsService" ref="goodsService"/> 

</bean> 


出 寺 ”可 





展示 和 交互 ， 应 该 支持 多 DA 
届 辑 层 功 能 ， 只 负责 调用 业务 逻辑 层 查找 数据 模型 并 委托 给 相应 的 视 


积分 商城 分 为 前 台 和 后 台 ， 前 台 负 责 与 客户 进行 交互 ， 如 购买 商品 ; 后 台 是 负责 商品 及 商品 
兑换 码 维护 的 ， 只 应 该 管理 员 有 权限 操作 。 


后 台 模 块 : 


。 商品 管理 模块 : 负责 商品 的 维护 ， 包 括 列 表 、 新 增 、 人 和 修改、 删除 、 查 询 所 有 商品 兑换 码 
功能 ; 
e 商品 兑换 码 管理 模块 : 包括 列表 、 新 增 、 删 除 所 有 兑换 码 操 作 :; 


前 台 模 块 : 只 有 已 发 布 商品 展示 ? 用 户 购 买 指 定 商品 时 ， ， 如 果 购 买 成 功 则 给 用 户 发 送 兑换 
码 ， 购 买 失 败 给 用 户 错误 提示 。 


表现 层 Action 实 现时 一 般 使 用 如 下 规约 编程 : 


e。 Action 方 法 定义 : 使 用 如 list 方 法 表示 展示 列表 ，doAdd 方 法 表示 去 新 增 页 面 ，add 方 法 表 
示 提 交 新 增 页 面 的 结果 并 委托 给 Service 层 进行 处 理 ; 
e@ 结果 定义 : 如 使 用 "list" 结 果 表 示 到 展示 列表 页 面 ，“add” 结 果 去 新 增 页 面 等 等 ; 


e。 参数 设置 : 一 般 使 用 如 "model" 表 示 数 据 模型 ， 使 用 "page" 表 示 分 页 对 象 。 
1、 集 成 Struts2 和 Spring 配置 


1.1、Spring Action 配 置 文件 : 即 Action 将 从 Spring 容器 中 获取 ， 前 台 和 后 台 配 置 文件 应 该 
分 开 以 便 好 管理 ; 


。 后 合 Action 配 置 文件 resources/cn/javass/web/pointShop-admin-servlet.xml; 
。 前 台 Action 配 置 文件 resources/cm/javass/web/pointShop-front-servlet.xml ; 


1.2、Struts 配 置 文件 定义 (resources/struts.xml) : 


为 了 提高 开发 效率 和 采用 规约 编程 ， 我 们 将 使 用 模式 匹配 通配符 来 定义 action。 对 于 管理 后 
和 前 台 应 该 分 开 ，URL 模 式 将 类 似 于 /{module}{actionY{method}.action : 


。 module 即 模块 名 如 admin，action 即 action 前 缓 名 ， 如 后 台 的 “GoodsAction" 可 以 使 
用 “goods”，method 即 Action 中 的 方法 名 如 "list"。 

。 可 以 在 Struts 配 置 文件 中 使 用 { 们 访问 第 一 个 通配符 匹配 的 结果 ， 以 此 类 推 ; 

e。 Reuslt 也 采用 规约 编程 ， 即 只 有 符合 规律 的 放置 jsp 文 件 才 会 匹配 到 ， 如 Result 为 “WEB- 
INF/jjsp/admin/{1Ylist.jsp”， 而 URL 为 /goodsllist.action 结果 将 为 "WEB- 
INF/jsp/admin/goods/list.jsp” ° 


<package name="admin" extends="custom-default" namespace="/admin"> 
<action name="*/*" class="/admin/{1}Action" method="{2}"> 
<result name="redirect" type="redirect">/admin/{1}/list.action</result> 
<result name="l1ist">/WEB-INF/jsp/admin/{1}/list.jsp</result> 
<result name="add">/WEB-INF/jsp/admin/{1}/add.jsp</result> 
</action> 
</package> 


在 此 我 们 继承 了 “custom-default” 包 来 支持 action 名 字 中 允许 “”。 


如 “/admin/goodsllist.action” 将 调用 cn.javass.point.web.admin.action.GoodsAction 的 list 方 
法 。 


<package name="front" extends="custom-default"> 

<action name="*/*" class="/front/{1}Action" method="{2}"> 
<result name="redirect" type="redirect">/{1}/list.action</result> 
<result name="list">/WEB-INF/jsp/front/{1}/list.jsp</result> 
<result name="add">/WEB-INF/jsp/front/{1}/add.jsp</result> 
<result name="buyResult">/WEB-INF/jsp/front/{1}/buyResult.jsp</result> 

</action> 

</package> 


如 “/goods/list.action” 将 调用 cn.javass.point.web.front.action.GoodsAction 的 list 方 法 。 


1.3、web.xml 瑟 置 : 将 Spring 配置 文件 加 上 ; 


<Context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value> 
classpath:applicationContext-resources.xml, 
classpath:cn/javass/point/dao/applicationContext-hibernate.xml, 
classpath:cn/javass/point/service/applicationContext-service.xml, 
classpath:cn/javass/point/web/pointShop-admin-servlet.xml, 
classpath:cn/javass/point/web/pointShop-front-servlet.xml 
</param-value> 
</context-param> 


2、 后 合 商品 管理 模块 
商品 管理 模块 实现 商品 的 CRUD， 本 示例 只 演示 新 增 ， 删 除 和 更 新 由 于 篇 幅 问 题 留 作 练 习 。 
2.1、Action 实现 


package cn.javass.point.web.admin.action; 
// 省 略 import 
public class GoodsAction extends BaseAction { 
public String List() {// 列 表 、 展 示 所 有 商品 (包括 未 发 布 的 ) 
getValueStack().set(PAGE, goodsService.1istAll(getPn())); 
return LIST; 


} 

public String doAdd() {// 到 新 增 页 面 
goods = new GoodsModel(); 
getValueStack( ) .set(MODEL，goods ) ; 
return ADD; 


public String add() {// 保 存 新 增 模型 对 象 
goodsService.save(goods); 
return REDIRECT; 


} 

// 字 段 驱 动 数据 填充 

private int id = -1;  // 前 台 提 交 的 商品 ID 
private GoodsModel goods; // 前 台 提 交 的 商品 模型 对 象 
// 省 略 字 段 驱 动 数据 的 getter 和 setter 

// 依 赖 注 入 Service 

private IGoodsService goodsService 

// 省 略 依赖 注入 的 getter 和 setter 


2.2、Spring 配 置 文件 定义 (resources/cn/javass/web/pointShop-admin-servlet.xml) 


<bean name="/admin/goodsAction" class="cn.javass.point.web.admin.action.GoodsAction" scop 
<property name="goodsService" ref="goodsService"/> 
</bean> 


二 = na 


2.3、JSP 实 现 商品 列表 页 面 (WEB.-INF/jsp/admin/goodsllist.jsp) 





查询 所 有 商品 ， 通 过 迭代 “page.items”(Page 对 象 的 tiems 属 性 中 存放 着 分 页 列表 数据 ) 来 显 
示 商 品 列表 ， 在 最 后 应 该 有 分 页 标签 (请 参考 源 代码 ， 示 例 无 )， 如 类 似 于 “<my:page 
i 页 元 素 。 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include pagea /r/comon/inc/header jsp"> 
<jsp:param name="title" value=" 商 品 管理 -商品 列表 "/> 
</jsp:include> 
<a href="${ctx}/admin/goods/doAdd.action"> 新 增 </a><br/> 
<table border="1"> 
<tr> 
<th>ID</th> 
<th> 商 品名 称 </th> 
<th> 商 品 描述 </th> 
<th> 原 需 积分 </th> 
<th> 现 需 积 分 </th> 
<th> 是 否 已 发 布 </th> 
<th></th> 
<th></th> 
<th></th> 
</tr> 
<s:iterator value="page.items"> 
<tr> 
<td><a href="${ctx}/admin/goods/toUpdate.action?id=<s:property value='id'/>"><s:p 
<td><s:property value="name"/></td> 
<td><s:property value="description"/></td> 
<td><s:property value="originalpPoint"/></td> 
<td><s:property value="nowPoint"/></td> 
<td><s:property value="published"/></td> 
<td> 更 新 </td> <td> 删 除 </td> 
<td><a href="${ctx}/admin/goodsCode/list.action?goodsId=<s:property value="'id'/>" 
</tr> 
</s:iterator> 
</table> 
<jsp:include page="../../common/inc/footer.jsp"/> 


男 — 


右 击 “pointShop” 项 目 选 择 【Run As】> 【Run On Server】 启 动 Tomcat 服 务 器 ， 在 浏览 器 中 输 
入 “http://localhost:8080/pointShop/admin/goods/list.action” 将 显示 图 11-11 界 面 。 





新 增 

[i0| 商品 名 称 商品 描述 ” |[ 原 需 积分 现 需 积分 | 是 否 已 发 布 | | 

[6_ 际 磨 设计 模式 一 本 值得 反复 阅读 的 书 [2e。 ee jtrue | 莉 新 三 
上 _ 际 磨 设计 模式 [一 本 值得 反复 阅读 的 书 [ze。 ee。 “|true ”| 葛 新 删除 潮 看 兑换 码 

ls 赋 磨 设计 模式 [一 本 值得 反复 阅读 的 书 [2ee -i true 匡 新 删除 这 看 兑换 码 5 


民生 隔世 水 搭 导 [一 二 信和 坦 后 旧 曾 污 乓 芋 I[sx EFT 


图 11-11 后 侣 商品 列表 页 面 
2.4、JSP 实 现 商品 新 增 页 面 (WEB.-INF/jsp/admin/goods/add.jsp) 


表单 提交 到 /admin/goods/add.action 即 cn.javass.point.web.admin.action.GoodsAction 的 add 
方法 。 并 将 参数 绑 定 到 goods 属 性 上 ， 在 此 我 们 没有 进行 数据 验证 ， 在 实际 项 目 中 页 面 中 和 
Action 中 都 要 进行 数据 验证 。 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8" %> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include page="../../common/inc/header.jsp"> 
<jsp:param name="title" value=" 商 品 管理 -新 增 "/> 
</jsp:include> 
<s:fielderror cssStyle="color:red"/> 
<s:form action="/admin/goods/add.action" method="POST" acceptcharset="UTF-8" > 
<s:token/> 
<table border="1"> 
<s:hidden name="goods.id" value="%{model.id}"/> 
<s:hidden name="goods.version" value="%{model.version}"/> 
<tr> 
<s:textfield label=" 商 品名 称 " name="goods.name" value="%{model.name}" required="trl 
</tr> 


<tr> 
<s:textarea label=" 商 品 简介 " name="goods.description" value="%{model.description}" 
</tr> 
<tr> 
<s:textfield label=" 原 需 积 分 " name="goods.originalPoint" value="%{model.originalPo.: 
</tr> 
<tr> 
<s:textfield label=" 现 需 积 分 " name="goods.nowPoint" value="%{model.nowPoint}" requ: 
</tr> 
<tr> 
<s:radio label=" 是 否 发 布 '" name="goods.published" 1ist="#{true:' 发 布 ', false:' 不 发 布 '} 
</tr> 
<tEr> 
<td><input name="submit" type="submit" value=" 新 增 "/></td> 
<td> 
<input name="cancel" type="button" onclick="javascript:window.location.href="'${ct 
</td> 
</tr> 
</table> 
</s:form> 
<jsp:include page="../../common/inc/footer.jsp"/> 


Ee EE: 


右 击 “pointShop” 选 择 【Run As】> 【Run On Server】 启 动 Tomcat 服 务 器 ， 在 商品 列表 页 面 单 
间 【新 增 】 按 钮 将 显示 图 11-11 界 面 。 





商品 名 称 * : || 研 局 设计 模式 











区 分 
现 需 积分 x: 有 po 
旦 否 发 布 :| 图 发 布 巴 不 发 布 
_ 新 增 | 取消 


图 11-12 后 台 商 品 新 增 页 面 














3、 后 台 兑 换 码 管理 


提供 根据 商品 ID 查询 兑换 码 列 表 及 新 增 兑 换 码 操作 ， 兑 换 码 通过 文本 框 输入 多 个 ， 使 用 换行 
分 割 。 
3.1、Action 实 现 


package cn.javass.point.web.admin.action; 

// 省 略 import 

public class GoodsCodeAction extends BaseAction { 

public String list() { 

getValueStack().set(MODEL, goodsService.get(goodsId)); 
getValueStack() .set(PAGE， 
goodscodeService.1istA1L1ByGoods(getPn()，goodsId) ); 
return LIST; 


public String doAdd() { 
getValueStack().set(MODEL, goodsService.get(goodsId)); 
return ADD; 


} 

public String add() { 
String[] codes = splitCodes(); 
goodsCodeService,.save(goodsId, codes); 
return list(); 


} 
private String[] splitCodes() {// 将 根据 换行 分 割 cCode 码 
if(codes == null) { 
return new String[0]; 


return codes.split("\r"); // 简 单 起 见 不 考 虑 4“Nn7 


} 

// 字 段 驱 动 数据 填充 

private int id = -1; // 前 台 提 交 的 商品 兑换 码 ID 
private :int goodsId = -1; // 前 人 台 提 交 的 商品 ID 
private String codes;// 前 台 提交 的 兑换 码 ， 由 换行 分 割 
private GoodsCodeModel goodsCode; // 前 台 提 交 的 商品 兑换 码 模型 对 象 
// 省 略 字段 驱动 数据 的 getter 和 Setter 

// 依 赖 注 入 Service 

private IGoodsCodeService goodsCcodeService 
private IGoodsService goodsService 

// 省 略 依赖 注入 的 getter 和 setter 


3.2、Spring 配 置 文件 定义 (resources/cn/javass/web/pointShop-admin-servlet.xm|l) 


<bean name="/admin/goodsCodeAction" 
class="cn.javass.point.web.admin.action.GoodsCodeAction" scope="prototype"> 
<property name="goodsService" ref="goodsService"/> 

<property name="goodsCodeService" ref="goodsCodeService"/> 
</bean> 


3.3、JSP 实 现 商 品 兑换 码 列表 页 面 (WEB.-INF/jsp/admin/goodsCodellist.jsp) 


商品 兑换 码 列表 页 面 时 将 展示 相应 商品 的 兑换 码 。 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include page="../../common/inc/header.jsp"> 
<jsp:param name="title" value=" 商 品 管理 -商品 Code 码 列表 "/> 
</jsp:include> 
<a href="${ctx}/admin/goodsCode/doAdd.action?goodsId=${model.id}"> 新 增 </a>| 
<a href="${ctx}/admin/goods/1ist.action"> 返 回 商品 列表 </a><br/> 
<table border="1"> 
<tr> 
<th>ID</th> 
<th> 所 属 商品 </th> 
<th> 兑 换 码 </th> 
<th> 购 买 人 </th> 
<th> 兑 换 时 间 </th> 
<th> 是 否 已 经 兑换 </th> 
<th></th> 
</tr> 
<s:iterator value="page.items"> 
<tr> 
<td><s:property value="id"/></td> 
<td><s:property value="goods.name"/></td> 
<td><s:property value="code"/></td> 
<td><s:property value="username"/></td> 
<td><s:date name="exchangeTime" format="yyyy-MM-dd"/></td> 
<td><s:property value="exchanged"/></td> 
<td> 出 除 </td> 
</tr> 
</s:iterator> 
</table> 
<jsp:include page="../../common/inc/footer.jsp"/> 


右 击 “pointShop” 选 择 【Run As】> 【Run On Server】 启 动 Web 服 务 器 ， 在 浏览 器 中 输 
入 “http://localhost:8080/pointShop/admin/goods/list.action”， 然 后 在 指定 商品 后 边 点 
兑换 码 】 将 显示 图 11-15 界 面 。 


新 增 | 返回 商品 列表 
[| 所 属 商品 | ”兑换 码 | 购买 人 [ 郭 换 时 间 [ 杏 香 已 经 兑换 | 
六 耳 麻 设计 模式 |12234443232 | [false 购 除 








|2 了 荆 磨 设计 模式 342342342342 |false 兽 除 
| | [false 删除 





车 麻 设 计 模式 |3423424234234 


图 11-15 商品 兑换 码 列表 





3.4、JSP 实 现 商 品 兑换 码 新 增 页 面 (WEB.-INF/jsp/admin/goodsCode/add.jsp) 


用 于 新 增 指定 商品 的 兑换 码 。 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include page="../../common/inc/header.jsp"> 
<jsp:param name="title" value=" 用 户 管理 -新 增 "/> 
</jsp:include> 
<s:fielderror cssStyle="color:red"/> 
<s:form action="/admin/goodsCode/add.action" method="POST" acceptcharset="UTF-8"> 
<s:token/> 
<s:hidden name="goodsId" value="%{model.id}" /> 
<table border="1"> 


<tr> 

<s:textfield label=" 所 属 商 品 " name="model.name" readonly="true"/> 
</tr> 
过 七 下 二 

<s:textarea label="code 码 " name="codes" cols="20" rows="3"/> 
</tr> 
< 这 


<td><input name="submit" type="submit" value=" 新 增 "/></td> 
<td><input name="cancel" type="button" onclick="javascript:window.location.href='$ 
</tr> 
</table> 
</s:form> 
<jsp:include page="../../common/inc/footer.jsp"/> 


加 于 盖 





己 


右 击 “pointShop” 选 择 【Run As】> 【Run On Server】 局 动 Tomcat 服 务 器 ， 在 商品 兑换 码 列 表 


中 单 击 【 新 增 】 按钮 将 显示 图 11-16 界 面 。 


所 属 商品 : [ 阿 阁 设计 看 式 
11232323 





图 11-16 兑换 码 新 增 页 面 
4、 前 台 商 品 展示 及 购买 模块 : 


前 台 商品 展示 提供 商品 展示 及 购买 页 面 ， 购 买 时 应 考虑 是 否 有 足够 兑换 码 等 ， 此 处 错误 消息 
使 用 硬 编码 ， 应 该 考虑 使 用 国际 化 支持 ， 请 参考 学 习 国 际 化 。 


4.1、Action 实 现 


package cn.javass.point.web.front.action; 
// 省 略 import 
public class GoodsAction extends BaseAction { 
private static final String BUY_RESULT = "buyResult"; 
public String list() { 
getValueStack().set(PAGE, goodsService.1istAllPublished(getPn())); 
return LIST; 


} 
public String buy() { 


String username = "test",; 
GoodsCodeModel goodsCode = null; 
try { 


goodsCode = goodsCodeService.buy(username, goodsId); 
} catch (NotCodeException e) { 

this.addActionError(" 没 有 足够 的 兑换 码 了 ")， 

return BUY_RESULT; 
} catch (Exception e) { 

e.printStackTrace( ); 

this.addActionError(" 未 知 错误 ")， 

return BUY_RESULT; 


this.addActionMessage(" 购 买 成 功 ， 您 的 兑换 码 为 :"+ goodsCode.getCcode()); 
getValueStack().set(MODEL, goodsCode); 
return BUY_RESULT; 


} 

// 字 段 驱 动 数据 卉 充 

private int goodsId ; 

// 省 略 字段 驱动 数据 的 getter 和 setter 

// 依 赖 注 入 Service 

IGoodsService goodsService 
IGoodsCodeService goodsCodeService; 
// 省 略 依赖 注入 的 getter 和 setter 


4.2、Spring 配 置 文件 定义 (resources/cn/javass/web/pointShop-front-servlet.xml) 


<bean name="/front/goodsAction" class="cn.javass.point.web,.front.action.GoodsAction" scop 
<property name="goodsService" ref="goodsService"/> 
<property name="goodsCodeService" ref="goodsCodeService"/> 

</bean> 


加 nD 





4.3、JSP 实 现 前 人 台 商 品 展示 及 购买 页 面 (WEB-INF/jsp/ goodsilist.jsp) 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include page="../../common/inc/header.jsp"> 
<jsp:param name="title" value=" 积 分 商城 -商品 列表 "/> 
</jsp:include> 
<s:iterator value="page.items" status="status"> 
<s:property value="#status.index + 1"/>.<s:property value="name"/> 
<a href="${ctx}/goods/buy.action?goodsId=<s:property value='id'/>"> 【购买 】 </a><br/: 
描述 :<s:property value="description"/><br/> 
<s> 需 要 积分 <s:property value="originalPoint"/></s>&nbsp;&nbsp; 现 需 积 分 : <b><s:propert 
</s:iterator> 
<jsp:include page="../../common/inc/footer.jsp"/> 


剧 : 





右 击 “pointShop” 选 择 【Run As】> 【Run On Server】 启 动 Web 服 务 器 ， 在 浏览 器 中 输 
入 http://localhost:8080/pointShop/goodsllist.action 将 显示 图 11-17 界 面 。 


1 .研磨 设 计 模式 【购买 ] 
描述 ， 一 本 值得 反复 同谋 的 书 
需 村 现 需 积分 : 188 
2 .研磨 职 计 司 式 【购买 】 

描述 : 一 本 值得 反复 阅读 的 书 
需要 积分 288 现 需 积分 : 188 
3 .研磨 级 计 模 式 【购买 】 

描述 : 一 本 值得 反复 阅读 的 书 
二 上 2 现 需 积分 : 16 六 


图 11-17 前 台 商 品 展示 即 购 买 页 

在 前 台 商 品 展 示 即 购买 页 面 中 点 击 购买 ， 如 果 库 存 中 还 有 兑换 码 ， 将 购买 成 功 ， 否 则 购买 失 
败 。 

4.3、 商 品 购买 结果 页 面 (WEB-INF/jsp/admin/goods/buyResultjsp ) 


购买 成 功 将 通过 “<s: Co 签 显 示 成 功 信息 并 将 0 给 用 户 ， 购 买 失败 将 
通过 “<s:actionerror/>” 标 签 提 示 如 积分 不 足 或 兑换 码 没 有 了 等 错误 信息 


<%@ page language="java" pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%> 
<%@ include file="../../common/inc/tld.jsp"%> 
<jsp:include page="../../common/inc/header.jsp"> 
<jsp:param name="title" value=" 积 分 商城 -购买 结果 "/> 
</jsp:include> 
<s:actionerror/> 
<s:actionmessage/> 
<jsp:include page="../../common/inc/footer.jsp"/> 


在 商品 展示 及 购买 列表 购买 成 功 或 失败 将 显示 图 11-18 或 图 11-19 界 面 。 
。 购买 成 功 ， 您 的 兑换 码 为 :12234443232 


图 11-18 购买 成 功 页 面 


。 设 有 丘 胡 的 部 换 码 了 


图 11-19 购买 失败 页 面 
到 此 SSH 集 成 已 经 结束 ， 集 成 SSH 是 非常 简单 的 ， 但 开发 流程 及 开发 思想 是 关键 。 


我 们 整个 开发 过 a nn nen ， 其 次 
ee 分 ) ， 因 为 每 个 项 目的 功能 是 不 一 样 的 。 在 开发 
过 程 中 还 集中 将 重复 内 容 提 取 到 一 0 后 修改 。 


跟 我 学 Spring 系列 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/2516.html] 


【第 十 一 章 】 SSH 集 成 开发 积分 商城 之 11.3 实现 积分 商城 层 一 一 跟 我 学 spring3 330 


【第 十 二 章 】 零 配置 之 12.1 概述 一 一 跟 我 学 
spring3 


12.1 概述 


12.1.1 什么 是 零 配置 


在 SSH 集 成 一 章 中 大 家 注意 到 项 目 结构 和 和 包 结构 是 不 是 很 有 规律 ， 类 库 放 到 WEB-INF/lib 文 件 
夹 下 ，jsp 文 件 放 到 WEB-INF/jsp 文 件 夹 下 ，web.xml 需 要 放 到 WEB-INF 文 件 夹 下 等 等 ， 为 什么 
要 这 么 放 呢 ?不 这 样 放 可 以 吗 ? 


所 谓 零 配置 ， 并 不 是 说 一 点 配置 都 没有 了 ， 而 是 配置 很 少 而 已 。 通 过 约定 来 减少 需要 配置 的 
数量 ， 提 高 开发 效率 。 


因此 SSH 集 成 时 的 项 目 结构 和 包 结 构 完全 是 任意 的 ， 可 以 通过 配置 方式 来 指定 位 置 ， 因 此 如 
web.xml 完 全 可 以 不 放 在 WEB-INF 下 边 而 通过 如 tomcat 配 置 文件 中 新 指定 web.xml 位 置 。 


还 有 在 SSH 集 成 中 还 记得 使 用 在 Struts2 配 置 文件 中 使 用 模式 匹配 通配符 来 定义 action， 只 要 我 
们 的 URL 模 式 将 类 似 于 /{module}Y{actionM{method}.action 即 可 自动 映射 到 相应 的 Action 类 的 方 
法 上 ， 但 如 果 你 的 URL 不 对 肯定 是 映射 不 到 的 ， 这 就 是 规约 。 


零 配 置 并 不 是 没有 配置 ， 而 是 通过 约定 来 减少 配置 。 那 如 何 实现 零 配 置 呢 ? 


12.1.2 零 配 置 的 实现 方式 
零 配 置 实现 主要 有 以 下 两 种 方式 : 


e@ 惯例 优先 原则 : 也 称 为 约定 大 于 配置 或 规约 大 于 配置 (convention over 
configuration) ， 即 通过 约定 代码 结构 或 命名 规范 来 减少 配置 数量 ， 同 样 不 会 减少 配置 
件 ; 即 通过 约定 好 默认 规范 来 提高 开发 效率 ; 如 Struts2 配 置 文件 使 用 模式 匹配 通 全 
定义 action 就 是 惯例 优先 原则 。 

e@。 基于 注解 的 规约 配置 : 通过 在 指定 类 上 指定 注解 ， 通 过 注解 约定 其 含义 来 减少 配置 数 
量 ， 从 而 提高 开发 效率 ; 如 事务 注解 @Transaction 是 不 是 基于 注解 的 规约 ， 只 有 在 指定 
的 类 或 方法 上 使 用 该 注解 就 表示 其 需要 事务 


对 惯例 优先 原则 支持 的 有 项 目 管 理工 具 Maven， 它 约定 了 一 套 非常 好 的 项 目 结 构 和 一 套 合理 
的 默认 值 来 简化 日 常 开发 ， 作 者 比较 喜欢 使 用 Maven 构 建 和 管理 项 目 ; 另外 还 有 Strtus2 的 


A A 


convention-plugin 也 提供 了 零 配 置 支 持 等 等 。 


大 家 还 记得 【7.5 集成 Spring JDBC 及 最 佳 实践 】 时 的 80/20 法 则 吗 ? 零 配置 是 不 是 同样 很 好 
的 体现 了 这 个 法 则 ， 在 日 常 开发 中 同样 80% 时 间 使 用 默认 配置 ， 而 20% 时 间 可 能 需要 特定 配 
置 O 

12.1.3 Spring3 的 零 配 置 

Spring3 中 零 配 置 的 支持 主要 体现 在 Spring Web MVC 框 架 的 惯例 优先 原则 和 基于 注解 配置 。 
Spring Web MVC 框 架 的 惯例 优先 原则 采用 默认 的 命名 规范 来 减少 配置 。 


Spring 基于 注解 的 配置 采用 约定 注解 含义 来 减少 配置 ， 包 括 注 解 实现 Bean 配 置 、 注 解 实 现 
Bean 定 义 和 Java 类 替换 配置 文件 三 部 分 


。 注解 实现 Bean 依 赖 注入 : 通过 注解 方式 替代 基于 XML 配置 中 的 依赖 注入 ， 如 使 用 
@Autowired De 注入 。 
e@ 注解 实现 Bean 定 义 : 通过 注解 方式 进行 Bean 配 置 元 数据 定义 ， 从 而 完全 将 Bean 配 置 元 


数据 从 配置 文件 中 移 除 。 
e Java 类 替换 配置 文件 : 使 用 Java 类 来 定义 所 有 的 Spring 配置 ， 完 全 消除 XML 配置 文件 。 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/0/2543.html]】 


[第 十 二 章 】 零 配置 之 12.2 注解 实现 Bean 依 赖 注 
入 一 一 跟 我 学 spring3 


12.2 注解 实现 Bean 依 赖 注入 


12.2.1 概述 


注解 实现 Bean 配 置 主 要 用 来 进行 如 依赖 注入 、 生 命 周期 回调 方法 定义 等 ， 不 能 消除 XML 文件 
中 的 Bean 元 数据 定义 ， 且 基于 XML 配置 中 的 依赖 注入 的 数据 将 履 盖 基于 注解 配置 中 的 依赖 注 
入 的 数据 。 


Spring3 的 基于 注解 实现 Bean 依 赖 注 入 支持 如 下 三 种 注解 : 


。 Spring 自 带 依赖 注入 注解 : Spring 自 带 的 一 套 依 赖 注 入 注解 ; 

。 JSR-250 注 解 : Java 平 台 的 公共 注解 ， 是 Java EE 5 规范 之 一 ， 在 JDK6 中 默认 包含 这 些 
注解 ， 从 Spring2.5 开 始 支 持 。 

。 JSR-330 注 解 : Java 依赖 注入 标准 ，Java EE 6 规范 之 一 ， 可 能 在 加 入 到 未 来 JDK 版 本 ， 
从 Spring3 开 始 支持 ; 

e。 JPA 注 解 : 用 于 注入 持久 化 上 下 文 和 尸体 管理 器 。 


这 三 种 类 型 的 注解 在 Spring3 中 都 支持 ， 类 似 于 注解 事务 支持 ， 想 要 使 用 这 些 注 解 需要 在 
Spring 容器 中 开局 注解 驱动 支持 ， 即 使 用 如 下 配置 方式 开局 : 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation=" http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-3.0.xsd"> 
<context:annotation-config/> 


</beans> 


这 样 就 能 使 用 注解 驱动 依赖 注入 了 ， 该 配置 文件 位 于 “resources/ 
chapter12/dependecylnjectWithAnnotation.xml” °。 

12.2.2 Spring 自 带 依 赖 注 入 注解 

一 、@Required : 依赖 检查 ; 


对 应 于 基于 XML 配置 中 的 依赖 检查 ， 但 XML 配置 的 依赖 检查 将 检查 所 有 setter 方 法 ， 详 见 
【3.3.4 依赖 检查 】 : 


基于 @Required 的 依赖 检查 表示 注解 的 setter 方 法 必须 ， 即 必须 通过 在 XML 配置 中 配置 setter 
注入 ， 如 果 没 有 配置 在 容器 启动 时 会 抛 出 异常 从 而 保证 在 运行 时 不 会 遇 到 空 指针 蜡 常 ， 
@Required 只 能 放置 在 setter 方 法 上 ， 且 通过 XML 配 置 的 setter 注 入 ， 可 以 使 用 如 下 方式 来 指 


>= 


不 ， 


@Requried 
setter 方 法 


1、 准 备 测试 Bean 


package cn.javass.spring.chapter12; 
public class TestBean { 
private String message; 
@Required 
public void setMessage(String message) { 
this.message = message; 


} 

public String getMessage() { 
return message; 

} 


2、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean" class="cn.javass.spring.chapter12.TestBean"> 
<property name="message" ref="message"/> 
</bean> 
<bean id="message" class="java.lang.string"> 
<constructor-arg index="0" value="hello"/> 
</bean> 


3、 测 试 类 和 测试 方法 如 下 : 


package cn.javass.spring.chapter12; 


// 省 略 import 
public class DependencyInjectwithAnnotationTest { 
private static String configLocation = "classpath:chapter12/dependecyInjectwithAnnota 


private static ApplicationContext ctx = new ClassPathxmlApplicationContext(configLoca 
//1、Spring 自 带 依赖 注入 注解 
QTest 
public void testRequiredForXmlSetterInject() { 
TestBean testBean = ctx.getBean("testBean", TestBean.class); 
Assert.assertEquals("hello", testBean.getMessage()); 


加 = a 


在 XML 配置 文件 中 必须 指定 setter 注 入 ， 否 则 在 Spring 容器 启动 时 将 抛 出 如 下 异常 : 





org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'testBean' defined in class path resource [chapter12/depend 
nested exception is org.springframework.beans.factory.BeanInitializationException: Proper 
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二 、@Autowired : 自动 装配 
自动 装配 ， 用 于 替代 基于 XML 配置 的 自动 装配 ， 详 见 【3.3.3 自动 装配 】。 


基于 @Autowired 的 自动 装配 ， 默 认 是 根据 类 型 注入 ， 可 以 用 于 构造 器 、 字 段 、 方 法 注入 ， 使 
用 方式 如 下 : 


@Autowired(required=true) 
构造 器 、 字 段 、 方 法 


@Autowired 默 认 是 根据 参数 类 型 进行 自动 装配 ， 且 必须 有 一 个 Bean 候 选 者 注入 ， 如 果 允 许 出 
现 0 个 Bean 候 选 者 需要 设置 属性 “required=false” "required "属性 含义 和 @Required 一 样 ， 只 
是 @Reqduired 只 适用 于 基于 XML 配置 的 setter 注 入 方式 。 


(1) 、 构 造 器 注入 : 通过 将 @Autowired 注 解放 在 构造 器 上 来 完成 构造 器 注入 ， 默 认 构 造 器 
参数 通过 类 型 自动 装配 ， 如 下 所 示 : 


1、 准 备 测试 Bean， 在 构造 器 上 添加 @AutoWired 注 解 : 


package cn.javass.spring.chapter12; 
import org.springframework.beans.factory.annotation.Autowired; 
public class TestBean11 { 
private String message; 
@Autowired // 构 造 器 注入 
private TestBean11(String message) { 
this.message = message; 


} 
// 省 略 message 的 getter 和 setter 


2、 在 Spring 配置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean Id="testBean11"” class="cn.]javass.spring.chapter12.TestBean11"/> 


3、 测 试 类 如 下 : 


@Test 

public void testAutowiredForConstructor() { 
TestBean11 testBean11 = ctx.getBean("testBean11i", TestBeani11.class); 
Assert.assertEquals("hello", testBeanii1.getMessage()); 


在 Spring 配 置 文件 中 没有 对 “testBean11” 进 行 构造 器 注入 和 setter 注 入 配置 ， 而 是 通过 在 构造 
器 上 添加 @ Autowired 来 完成 根据 参数 类 型 完成 构造 器 注入 。 


(2) 、 字 段 注入 : 通过 将 @Autowired 注 解放 在 构造 器 上 来 完成 字段 注入 。 


1、 准 备 测试 Bean， 在 字段 上 添加 @AutoWired 注 解 : 


2 


package cn.javass.spring.chapter12; 
import org.springframework.beans.factory.annotation.Autowired; 
public class TestBean12 { 

@Autowired // 字 段 注入 

private String message; 

// 省 略 getter 和 Setter 


\“ 在 Spring 配置 文件 《chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 


置 : 
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<bean id="testBean12" class="cn.javass.spring.chapter12.TestBean12"/> 


、 测试 方法 如 下 : 


@Test 

public void testAutowiredForField() { 
TestBean12 testBean12 = ctx.getBean("testBean12", TestBean12.class); 
Assert.assertEquals("hello", testBean1i2.getMessage()); 


字段 注入 在 基于 XML 配置 中 无 相应 概念 ， 字 段 注 入 不 支持 静态 类 型 字段 的 注入 。 
方 


3) 、 方 法 参数 注入 : 通过 将 @Autowired 注 解放 在 方法 上 来 完成 方法 参数 注入 。 


、 准 备 测试 Bean， 在 方法 上 添加 @AutoWired 注 解 : 


package cn.javass.spring.chapter12; 
import org.springframework.beans.factory.annotation.Autowired; 
public class TestBean13 { 
private String message; 
@Autowired //setter 方 法 注入 
public void setMessage(String message) { 
this.message = message; 


} 

public String getMessage() { 
return message; 

} 


package cn.javass.spring.chapter12; 
// 省 略 import 
public class TestBean14 { 
private String message; 
private List<String> list; 
@Autowired(required = true) // 任 意 一 个 或 多 个 参数 方法 注入 
private void initMessage(String message, ArrayList<String> list) { 
this.message = message; 
this.1list = lJist; 


} 
// 省 略 getter 和 Setter 


\“ 在 Spring 配置 文件 《chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 


置 : 


<bean Id="testBean13"” class='"cn,.javass,Sspring.chapter12.TestBean13"/> 
<bean id="testBean14" class="cn.javass.spring.chapter12.TestBean14"/> 
<bean id="]ist" class="java.util.ArrayList"> 
<constructor-arg index="0"> 
<list> 
<ref bean="message"/> 
<ref bean="message"/> 
</list> 
</constructor-arg> 
</bean> 


3、 测 试 方法 如 下 : 


@Test 

public void testAutowiredForMethod() { 
TestBean13 testBean13 = ctx.getBean("testBean1i3", TestBeani13.class); 
Assert.assertEquals("hello", testBeani3.getMessage()); 
TestBean14 testBean14 = ctx.getBean("testBean1i4", TestBean14.class); 


Assert.assertEquals("hello", testBeani4.getMessage()); 
Assert.assertEquals(ctx.getBean("list", List.class), testBean1i4.getList()); 


方法 参数 注入 除了 支持 setter 方 法 注入 ， 还 支持 1 个 或 多 个 参数 的 普通 方法 注入 ， 在 基于 XML 
置 中 不 支持 1 个 或 多 个 参数 的 普通 方法 注入 ， 方 法 注入 不 支持 静态 类 型 方法 的 注入 。 


注意 “initMessage(String message, ArrayList<String> list)” 方 法 签名 中 为 什么 使 用 
ArrayList 而 不 是 List 呢 ? 具体 参考 【3.3.3 自动 装配 】 一 节 中 的 集合 类 型 注入 区 别 。 


三 、@Value : 注入 SpEL 表 达 式 ; 


用 于 注入 SpEL 表 达 式 ， 可 以 放置 在 字段 方法 或 参数 上 ， 使 用 方式 如 下 : 


@Value(value = "SpEL 表 达 式 ") 
字段 、 方 法 、 参 数 


1、 可 以 在 类 字段 上 使 用 该 注解 : 


@Value(value = "#{message}") 
private String message; 


2、 可 以 放置 在 带 @Autowired 注 解 的 方法 的 参数 上 : 


@Autowired 

public void initMessage(@Value(value = "#{message}#{message}") String message) { 
this.message = message; 

} 


、 还 可 以 放置 在 带 @Autowired 注 解 的 构造 器 的 参数 上 : 


@Autowired 

private TestBean43(@Value(value = "#{message}#{message}") String message) { 
this.message = message; 

} 


具体 测试 详 见 DependencylnjectWithAnnotationTest 类 的 testValuelnject 测 试 方法 。 
四 、@Qualifier : 限定 描述 符 ， 用 于 细 粒 度 选择 候选 者 ; 


@Autowired 默 认 是 根据 类 型 进行 注入 的 ， es 类 型 一 样 的 Bean 候 选 者 ， 则 需要 限 


定 其 中 一 个 候选 者 ， 否 则 将 抛 出 异常 ， 详 见 【3.3.3 自动 装配 】 中 的 根据 类 型 进行 注入 ; 
@Qualifier 限 定 描述 符 除 了 能 根据 名 字 进 行 注 入 ， 但 能 进行 更 细 粒 度 的 控制 如 何 选择 候选 者 ， 
具体 使 用 方式 如 下 

@Qualifier(value = "限定 标识 符 " ) 


字段 、 方 法 、 参 数 


(1) 、 根 据 基 于 XML 配置 中 的 <qualifier> 标 签 指定 的 名 字 进 行 注入 ， 使 用 如 下 方式 指定 名 
称 : 


<qualifier type="org.springframework.beans.factory.annotation.Qualifier" value=" 限 定 标识 . 


= 





其 中 type 属 性 可 选 ， 指 定 类 型 ， 上 默认 就 是 Qualifier 注 解 类 ，name 就 是 给 Bean 候 选 者 指定 限定 
标识 符 ， 一 个 Bean 定 义 中 只 允许 指定 类 型 不 同 的 <qualifier>， 如 果 有 多 个 相同 type 后 面 指定 的 
将 覆盖 前 面 的 。 


1、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 

import javax.sql.DataSource; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.beans.factory.annotation.Qualifier; 


public class TestBean31 { 
private DataSource dataSource; 
Q@Autowired 
// 根 据 <qualLifier> 标 签 指定 Bean 限 定 标识 符 
public void initDataSource(@Qualifier("mysqlDataSource") DataSource dataSource) { 
this.dataSource = dataSource 


public DataSource getDataSource() { 
return dataSource; 
} 


2、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean31" class="cn.]javass.spring.chapter12.TestBean31"/> 


我 们 使 用 @Qualifier("mysqlDataSource") 来 指定 候选 Bean 的 限定 标识 答 ， 我 们 需要 在 配置 文 
件 中 使 用 <qualifier> 标 签 来 指定 候选 Bean 的 限定 标识 符 “mysqlDataSource”: 
<bean id="mysqlDataSourceBean" class="org.springframework.jdbc.datasource.DriverManagerDa 


<qualifier value="mysqlDataSource"/> 
</bean> 


可 








3、 测 试 方法 如 下 : 


@Test 
public void testQualifierInject1() { 
TestBean31 testBean31 = ctx.getBean("testBean31", TestBean31.class); 
try { 
// 使 用 <qualifier> 指 定 的 标识 符 只 能 被 @Qualifier 使 用 
ctx.getBean("mysqlDataSource"); 
Assert.fail( ); 
} catch (Exception e) { 
// 找 不 到 该 Bean 
Assert.assertTrue(e instanceof NoSuchBeanDefinitionException); 
} 
Assert.assertEquals(ctx.getBean("mysqlDataSourceBean"), testBean31.getDataSource()); 


; 
二 | 


从 测试 可 以 看 出 使 用 <qualifier> 标 签 指定 的 限定 标识 符 只 能 被 @Qualifier 使 用 ， 不 能 作为 Bean 
的 标识 符 ， 如 “ctx.getBean("mysqlDataSource")" 是 获取 不 到 Bean 的 。 


(2) 、 缺 省 的 根据 Bean 名 字 注 入 : 最 基本 方式 ， 是 在 Bean 上 没有 指定 <qualifier> 标 签 时 一 
种 容错 机 制 ， 即 缺 省 情况 下 使 用 Bean 标 识 符 注入 ， 但 如 果 你 指定 了 <qualifier> 标 签 将 不 会 发 
生 容错 。 


1、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
// 省 略 import 
public class TestBean32 { 
private DataSource dataSource,; 
@Autowired 
@Qualifier(value = "mysqlDataSource2") // 指 定 Bean 限 定 标识 符 
//Q@Qualifier(value = "mysqlDataSourceBean") 
// 是 错误 的 注入 ， 不 会 发 生 回 退 容错 ， 因 为 你 指定 了 <qualifier> 
public void initDataSource(DataSource dataSource) { 
this.dataSource = dataSource; 


public DataSource getDataSource() { 
return dataSource; 
} 


2、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean32" class="cn.]javass.spring.chapter12.TestBean32"/> 
<bean id="oracleDataSource" class="org.springframework.jdbc.datasource.DriverManagerData 


a 





“| = 








3、 测 试 方法 如 下 : 


@Test 

public void testQualifierInject2() { 
TestBean32 testBean32 = ctx.getBean("testBean32", TestBean32.class); 
Assert.assertEquals(ctx.getBean("oracleDataSource"), testBean32.getDataSource()); 


默认 情况 下 ( 没 指定 <qualifier> 标 签 ) @Qualifier 的 value 属 性 将 匹配 Bean 标识 符 。 
(3) 、 扩 展 @Qualifier 限 定 描述 符 注 解 : 对 @Qualifier 的 扩展 来 提供 细 粒 度 选择 候选 者 ; 
具体 使 用 方式 就 是 自 定义 一 个 注解 并 使 用 @Qualifier 注 解 其 即 可 使 用 。 


首先 让 我 们 考虑 这 样 一 个 问题 ， 如 果 我 们 有 两 个 数据 源 ， 分 别 为 Mysql 和 Oracle， 因 此 注入 两 
者 相关 资源 时 就 牵扯 到 数据 库 相 关 ， 如 在 DAO 层 注入 SessionFactory 时 ， 当 然 可 以 采用 前 边 
介绍 的 方式 ， 但 为 了 简单 和 直观 我 们 希望 采用 自 定义 注解 方式 。 


1、 扩 展 @Qualifier 限 定 描述 符 注 解 来 分 别 表 示 Mysql 和 Oracle 数 据 源 


package cn.javass.spring.chapter12.qualifier; 

import org.springframework.beans.factory.annotation.Qualifier,; 

/xx 表示 注入 Mysql 相 关 */ 

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 

Q@Qualifier 

public @interface Mysdql { 


package cn.javass.spring.chapter12.qualifier; 

import org.springframework.beans.factory.annotation.Qualifier,; 

/** 表示 注入 0racle 相 关 */ 

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 

Q@Qualifier 

public @interface Oracle { 


} 


2、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
// 省 略 import 
public class TestBean33 { 
private DataSource mysqlDataSource; 
private DataSource oracleDataSource; 
Q@Autowired 
public void initDataSource(@Mysql DataSource mysdqlDataSource，@oracle DataSource orac 
this.mysqlDataSource = mysqlDataSource; 
this.oracleDataSource = oracleDataSource; 


public DataSource getMysqlDataSource() { 
return mysqlDataSource; 


public DataSource getOracleDataSource() { 
return oracleDataSource; 





3、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 “ 


<bean id="testBean33" class="cn.javass.spring.chapter12.TestBean33"/> 


4、 在 Spring 修改 定义 的 两 个 数据 源 : 


<bean id="mysqlDataSourceBean" class="org.springframework.jdbc,.datasource.DriverManagerDa 
<qualifier value="mysqlDataSource"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier.Mysql"/> 

</bean> 

<bean id="oracleDataSource" class="org.springframework.jdbc.datasource.DriverManagerDatas 
<qualifier type="cn.javass.spring.chapter12.qualifier.Oracle"/> 

</bean> 


es 


5、 测 试 方法 如 下 : 





@Test 

public void testQualifierInject3() { 
TestBean33 testBean33 = ctx.getBean("testBean33", TestBean33.class); 
Assert.assertEquals(ctx.getBean("mysqlDataSourceBean"), testBean33.getMysqlDataSoruce 
Assert.assertEquals(ctx.getBean("oracleDataSource"), testBean33.getOracleDataSoruce() 





测试 也 通过 了 ， 说 明 我 们 扩展 的 @Qualifier 限 定 描述 符 注 解 也 能 很 好 工作 。 


前 边 演示 了 不 带 属性 的 注解 ， 接 下 来 演示 一 下 带 参 数 的 注解 : 


1、 首 先 定义 数据 库 类 型 : 


package cn.javass.spring.chapter12.qualifier; 
public enum DataBase { 

ORACLE, MYSQL; 
} 


2、 其 次 扩展 @Qualifier 限 定 描述 符 注 解 


package cn.javass.spring.chapter12.qualifier; 

// 省 略 import 

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 


Q@Qualifier 
public @interface DataSourceType { 
String ip(); // 指 定 ip, 用 于 多 数据 源 情况 


DataBase database();// 指 定数 据 库 类 型 


3、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
import javax.sql.DataSource,; 
import org.springframework.beans.factory.annotation.Autowired; 
import cn.javass.spring.chapter12.qualifier.DataBase; 
import cn.javass.spring.chapter12.qualifier.DataSourceType; 
public class TestBean34 { 
private DataSource mysqlDataSource; 
private DataSource oracleDataSource; 
@Autowired 
public void initDataSourcel( 
@DatasourceType(ip="localhost", database=DataBase.MYSQL) 
DataSource mysqlDataSource, 
@DataSsourceType(ip="localhost", database=DataBase .ORACLE) 
DataSource oracleDataSource) { 
this.mysqlDataSource = mysqlDataSource; 
this.oracleDataSource = oracleDataSource; 


// 省 略 getter 方 法 


4、 在 Spring 配置 文件 《chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean34" class="cn.]javass.spring.chapter12.TestBean34"/> 


5、 在 Spring 修改 定义 的 两 个 数据 源 : 


<bean id="mysqlDataSourceBean" class="org.springframework.jdbc,.datasource.DriverManagerDa 
<qualifier value="mysqlDataSource"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier .Mysql"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier .DataSourceType"> 
<attribute key="ip" value="localhost"/> 
<attribute key="database" value="MYSQL"/> 
</qualifier> 
</bean> 
<bean id="oracleDataSource" class="org.springframework.jdbc.datasource.DriverManagerDatas 
<qualifier type="cn.javass.spring.chapter12.qualifier.Oracle"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier.DataSourceType"> 
<attribute key="ip" value="localhost"/> 
<attribute key="database" value="ORACLE"/> 
</qualifier> 
</bean> 


加 











6、 测 试 方法 如 下 : 


@Test 

public void testQualifierInject3() { 
TestBean34 testBean34 = ctx.getBean("testBean34", TestBean34.class); 
Assert.assertEquals(ctx.getBean("mysqlDataSourceBean"), testBean34.getMysqlDataSource 
Assert.assertEquals(ctx.getBean("oracleDataSource"), testBean34.getOracleDataSoruce() 


图 








测试 也 通过 了 ， 说 明 我 们 扩展 的 @Qualifier 限 定 描 述 符 注解 也 能 很 好 工作 。 
四 、 自 定义 注解 限定 描述 符 : 完全 不 使 用 @Qualifier， 而 是 自己 定义 一 个 独立 的 限定 注解 ; 


1、 首 先 使 用 如 下 方式 定义 一 个 自 定义 注解 限定 描述 符 : 


package cn.javass.spring.chapter12.qualifier; 
// 省 略 import 
@Target({ElementType.TYPE, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 
public @interface CustomQualifier { 
String value(); 
} 


2、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
// 省 略 import 
public class TestBean35 { 
private DataSource dataSoruce 
@Autowired 


public TestBean35(@CustomQualifier("oracleDataSource") DataSource dataSource) { 
this.dataSoruce = dataSource; 


public DataSource getDataSoruce() { 
return dataSoruce; 
} 


3、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean35" class="cn.]javass.spring.chapter12.TestBean35"/> 


、 然 后 在 Spring 配置 文件 中 注册 CustomQualifier 自 定义 注解 限定 描述 符 ， 只 有 注册 了 Spring 


<bean id="customAutowireConfigurer" class="org.Sspringframework,beans ,factory.annotation.C 
<property name="customQualifierTypes"> 
<set> 
<value>cn.javass.spring.chapter12.qualifier.CustomQualifier</value> 
</set> 


</property> 
</bean> 


4] 





有 





5、 测 试 方 法 如 下 : 


@Test 


public void testQualifierInject5() { 
TestBean35 testBean35 = 


ctx.getBean("testBean35", TestBean35.class); 
Assert.assertEquals(ctx.getBean("oracleDataSource"), testBean35.getDataSource()); 
} 


从 测试 中 可 看 出 ， 自 定义 的 和 Spring 自 带 的 没什么 区 别 ， 因 此 如 果 没 有 足够 的 理由 请 使 用 
Spring 自 带 的 Qualifier 注 解 。 


到 此 限定 描述 符 介绍 完毕 ， 在 此 一 定 要 注意 以 下 几 点 : 
e 限定 标识 符 和 Bean 的 描述 符 是 不 一 样 的 ; 
。 多 个 Bean 定 义 中 可 以 使 用 相同 的 限定 标识 符 ; 


e。 对 于 集合 、 数 组 、 字 典 类 型 的 限定 描述 符 注 入 ， 将 注入 多 个 具有 相同 限定 标识 符 的 
Bean。 


12.2.3 JSR-250 注 解 


一 、@Resource : 自动 装配 ， 默 认 根 据 类 型 装配 ， 如 果 指 定 name 属 性 将 根据 名 字 装 配 ， 可 
以 使 用 如 下 方式 来 指定 : 


@Resource(name = "标识 符 ") 
字段 或 setter 方 法 


1、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
import javax.annotation.Resource; 
public class TestBean41 { 
@Resource(name = "message") 
private String message; 
// 省 咯 getter 和 setter 


2、 在 Spring 配 置 文件 (chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean41" class="cn.javass.spring.chapter12.TestBean41"/> 


3、 测 试 方法 如 下 : 


QTest 

public void testResourceInject1() { 
TestBean41 testBean41 = ctx.getBean("testBean41", TestBean41.class); 
Assert.assertEquals("hello", testBean41.getMessage()); 

} 


使 用 非常 简单 ， 和 @Autowired 不 同 的 是 可 以 指定 name 来 根据 名 字 注 入 。 
使 用 @Resource 需 要 注意 以 下 几 点 : 


。 @Resource 注 解 应 该 只 用 于 setter 方 法 注入 ， 不 能 提供 如 @Autowired 多 参数 方法 注入 ; 

。 @Resource 在 没有 指定 name 属 性 的 情况 下 首先 将 根据 setter 方 法 对 于 的 字段 名 查找 资 
源 ， 如 果 找 不 到 再 根据 类 型 查找 ; 

。 @Resource 首 先 将 从 JNDI 环 境 中 查找 资源 ， 如 果 没 找到 默认 再 到 Spring 容器 中 查找 ， 医 
此 如 果 JNDI 环 境 中 有 和 Spring 容器 同名 的 资源 时 需要 注意 。 


| 


、@PostConstruct 和 PreDestroy : 通过 注解 指定 初始 化 和 销毁 方法 定义 ; 


1、 在 测试 类 TestBean41 中 添加 如 下 代码 : 


@PostConstruct 
public void init() { 
System.out.println("==========inNit"); 


@PreDestroy 

public void destroy() { 
System.out.println("==========destroy"); 

} 


2、 修 改 测试 方法 如 下 : 


@Test 

public void resourceInjectTest1() { 
((ClassPathxmlApplicationContext) ctx).registerShutdownHook(); 
TestBean41 testBean41 = ctx.getBean("testBean41", TestBean41.class); 
Assert.assertEquals("hello", testBean41.getMessage()); 

} 


类 似 于 通过 <bean> 标 签 的 inittmethod 和 destroy-method 属 性 指定 的 初始 化 和 销毁 方法 ， 但 具 
有 更 高 优先 级 ， 即 注解 方式 的 初始 化 和 销毁 方法 将 先 执行 。 


12.2.4 JSR-330 注 解 


在 测试 之 前 需要 准备 JSR-330 注 解 所 需要 的 jar 包 ， 到 spring-framework-3.0.5.RELEASE- 
dependencies.zip 中 拷贝 如 下 jar 包 到 类 路 径 : 


com.springsource.javax.inject-1.0.0.jar 


一 、@Inject : 等 价 于 默认 的 @Autowired， 只 是 没有 required 属 性 ; 


二 、@Named : 指定 Bean 名 字 ， 对 应 于 Spring 自 带 @Qualifier 中 的 缺 省 的 根据 Bean 名 字 注 入 
情况 ; 


三 、@Qualifier : 只 对 应 于 Spring 自 带 @Qualifier 中 的 扩展 @Qualifier 限 定 描述 符 注 解 ， 即 只 
能 扩展 使 用 ， 没 有 value 属 性 。 


1、 首 先 扩 展 @Qualifier 限 定 描 述 符 注解 来 表示 Mysql 数 据 源 


package cn.javass.spring.chapter12.qualifier; 

// 省 略 部 分 import 

Import javax.inject.Qualifier; 
@Target({ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 

Q@Qualifier 

public @interface JSR330Mysql { 

} 


2、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 
Import javax.inject.Inject,; 
import javax.inject.Named; 
import javax.sql.DataSource; 
import cn.javass.spring.chapter12.qualifier.JSR330Mysql; 
public class TestBean51 { 
private DataSource mysqlDataSource; 
private DataSource oracleDataSource; 
@Inject 
public void initDataSoruce( 
@JSR330Mysql  _ DataSource mysqlDataSource, 
Q@Named("oracleDataSource") DataSource oracleDataSource) { 
this.mysqlDataSource = mysqlDataSource; 
this.oracleDataSource = oracleDataSource; 


} 
// 省 略 getter 


3、 在 Spring 配置 文件 〈chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 : 


<bean id="testBean51" class="cn.javass.spring.chapter12.TestBean51"/> 


4、 在 Spring 修改 定义 的 mysqlDataSourceBean 数 据 源 : 


<bean id="mysqlDataSourceBean" class="org.Sspringframework,.jdbc,datasource,.DriverManagerDa 
<qualifier value="mysqlDataSource"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier .Mysql"/> 
<qualifier type="cn.javass.spring.chapter12.qualifier.DataSourceType"> 
<attribute key="ip" value="localhost"/> 
<attribute key="database" value="MYSQL"/> 
</qualifier> 
<qualifier type="cn.javass.spring.chapter12.qualifier.JSR330Mysql"/> 
</bean> 


引 _ | 


5、 测 试 方法 如 下 : 








@Test 

public void testInject() { 
TestBean51 testBean51 = ctx.getBean("testBean51", TestBean51.class); 
Assert.assertEquals(ctx.getBean("mysqlDataSourceBean"), testBean51.getMysqlDataSource 
Assert.assertEquals(ctx.getBean("oracleDataSource"), testBean51.getOracleDataSource() 


到 Eee 了 





测试 也 通过 了 ， 说 明 JSR-330 注 解 也 能 很 好 工作 。 
从 测试 中 可 以 看 出 JSR-330 注 解 和 Spring 自 带 注 解 依赖 注入 时 主要 有 以 下 特点 : 


e。 Spring 自 带 的 @Autowired 的 缺 省 情况 等 价 于 JSR-330 的 @Inject 注 解 ; 

。 Spring 自 带 的 @Qualifier 的 缺 省 的 根据 Bean 名 字 注 入 情况 等 价 于 JSR-330 的 @Named 注 
解 ; 

。 Spring 自 带 的 @Qualifier 的 扩展 @Qualifier 限 定 描 述 符 注解 情况 等 价 于 JSR-330 的 
@Qualifier 注 解 。 


12.2.5 JPA 注 解 


用 于 注入 EntityManagerFactory 和 EntityManager。 


1、 准 备 测试 Bean : 


package cn.javass.spring.chapter12; 

// 省 略 import 

public class TestBean61 { 
@PersistenceContext(unitName = "entityManagerFactory") 
private EntityManager entityManager; 


@PersistenceUnit(unitName = "entityManagerFactory") 
private EntityManagerFactory entityManagerFactory; 


public EntityManager getEntityManager() { 
return entityManager; 


public EntityManagerFactory getEntityManagerFactory() { 
return entityManagerFactory; 
} 


2、 在 Spring 配置 文件 《chapter12/dependecylnjectWithAnnotation.xml) 添加 如 下 Bean 配 
置 ， 


<import resource="classpath:chapter7/applicationContext-resources.xml"/> 
<import resource="classpath:chapter8/applicationContext-jpa.xml"/> 
<bean id="testBean61" class="cn.javass.spring.chapter12.TestBean61"/> 


此 处 需要 引用 第 七 章 和 八 章 的 配置 文件 ， 细 节 内 容 请 参考 七 八 两 章 。 


3、 测 试 方法 如 下 : 


@Test 

public void testJpaInject() { 
TestBean61 testBean61 = ctx.getBean("testBean61", TestBean61.class); 
Assert.assertNotNull(testBean61.getEntityManager()); 
Assert.assertNotNull(testBean61.getEntityManagerFactory()); 


测试 也 通过 了 ， 说 明 JPA 注 解 也 能 很 好 工作 。 


JPA 注 解 类 似 于 @Resource 注 解 同 样 是 先 根 据 unitName 属 性 去 JNDI 环 境 中 查找 ， 如 果 没 找到 
在 到 Spring 容器 中 查找 。 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/0/2545.html] 


【第 十 二 章 】 零 配置 之 12.3 注解 实现 Bean 定 义 
一 一 跟 我 学 spring3 


12.3 注解 实现 Bean 定 义 


12.3.1 概述 


前 边 介绍 的 Bean 定 义 全 是 基于 XML 方式 定义 配置 元 数据 ， 且 在 【12.2 注 解 实现 Bean 依 赖 注 
入 】 一 节 中 介绍 了 通过 注解 来 减少 配置 数量 ， 但 并 没有 完全 消除 在 XML 配置 文件 中 的 Bean 定 
义 ， 因 此 有 没有 方式 完全 消除 XML 配置 Bean 定 义 呢 ? 


Spring 提供 通过 扫描 类 路 径 中 的 特殊 注解 类 来 自动 注册 Bean 定 义 。 同 注解 驱动 事务 一 样 需 要 
开启 自动 打 描 并 注册 Bean 定 义 支持 ， 使 用 方式 如 下 (resources/chapter12/ 
componentDefinitionWithAnnotation.xml ) 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.0.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context-3.0.xsd"> 


<aop:aspectj-autoproxy /> 
<context:component-scan base-package="cn.javass.spring.chapter12"/> 


</beans> 


使 用 <context:component-scan> 标 签 来 表示 需要 要 自动 注册 Bean 定 义 ， 而 通过 base-package 
属性 指定 扫描 的 类 路 径 位 置 。 


<context:component-scan> 标 签 将 自动 开启 “注解 实现 Bean 依 赖 注入 ”支持 。 
此 处 我 们 还 通过 <aop:aspectj-autoproxy/> 用 于 开启 Spring 对 @AspectJ 风 格 切面 的 支持 。 
Spring 基 于 注解 实现 Bean 定 义 支 持 如 下 三 种 注解 : 


。 Spring 自 带 的 @Component 注 解 及 扩展 @Repository、@Service、@Controller ， 如 
图 12-1 所 示 ; 

。 JSR-250 1.1 版 本 中 中 定义 的 @ManagedBean 注 解 ， 是 Java EE 6 标准 规范 之 一 ， 不 包括 
在 JDK 中 ， 需 要 在 应 用 服务 器 环境 使 用 (如 Jboss) ， 如 图 12-2 所 示 ; 

。 JSR-330 的 @Named 注 解 ， 如 图 12-3 所 示 。 
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图 12-1 Spring 自 带 的 @Component 注 解 及 扩展 
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图 12-2 JSR-250 中 定义 的 @ManagedBean 注 解 及 自 定义 扩展 
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图 12-3 JSR-330 的 @Named 注 解 及 自 定义 扩展 
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图 12-2 和 图 12-3 中 的 自 定义 扩展 部 分 是 为 了 配合 Spring 自 带 的 模式 注解 扩展 自 定义 的 ， 并 不 包 
含 在 Java EE 6 规范 中 ， 在 Java EE 6 中 相应 的 服务 层 、DAO 层 功能 由 EJB 来 完成 。 

在 Java EE 中 有 些 注解 运行 放置 在 多 个 地 方 ， 如 @Named 允 许 放置 在 类 型 、 字 上段、 方法 参数 
上 等 ， 因 此 一 般 情况 下 放置 在 类 型 上 表示 定义 ， 放 置 在 参数 、 方 法 等 上 边 一 般 代表 使 用 (如 


AAA 


依赖 注入 等 等 ) 。 


12.3.2 Spring 自 带 的 @Component 注 解 及 扩展 


一 、@Component : 定义 Spring 管理 Bean， 使 用 方式 如 下 : 


@Component (" 标 识 符 " ) 
P0OJO 类 


在 类 上 使 用 @Component 注 解 ， 表 示 该 类 定义 为 Spring 管理 Bean， 使 用 默认 value (可 选 ) 属 
性 表示 Bean 标 识 符 。 


1、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.ApplicationContext; 
import org.springframework.stereotype.Component,; 
@Component ("component") 
public class TestCompoment { 

Q@Autowired 

private ApplicationContext ctx 

public ApplicationContext getCtx() { 

return ctx; 
} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测试 类 和 测试 方法 : 


package cn.javass.spring.chapter12; 


// 省 略 import 

public class ComponentDefinitionwithAnnotationTest { 
private static String configLocation = "classpath:chapter12/componentDefinitionWithAn 
private static ApplicationContext ctx = new ClassPathxmlApplicationContext(configLoca 
@Test 


public void testComponent() { 
TestCompoment component = ctx.getBean("component", TestCompoment.class); 
Assert.assertNotNull(component .getctx()); 





测试 成 功 说 明 被 @Component 注 解 的 POJO 类 将 自动 被 Spring 识 别 并 注册 到 Spring 容 器 中 ， 且 
自动 支持 自动 装配 。 


@AspectJ 风 格 的 切面 可 以 通过 @Compenent 注 解 标识 其 为 Spring 管理 Bean， 而 @Aspect 
注解 不 能 被 Spring 自动 识别 并 注册 为 Bean， 作 须 通过 @Component 注 解 来 完成 ， 示 例如 
下 : 


package cn.javass.spring.chapter12.aop; 

// 省 略 import 

@Component 

@Aspect 

public class TestAspect { 
@Pointcut(value="execution(* *(..))") 
private void pointcut() {} 
@Before(value="pointcut()") 
public void before() { 

System.out.println("=======before"); 

} 


通过 @Component 将 切面 定义 为 Spring 管理 Bean 。 


二 、@Repository : @Ccomponent 扩 展 ， 被 @Repository 注 解 的 POJO 类 表示 DAO 层 实现 ， 
从 而 见 到 该 注解 就 想到 DAO 层 实现 ， 使 用 方式 和 @Component 相 同 ; 


1、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12.dao.hibernate; 
import org.springframework.stereotype.Repository; 
@Repository("testHibernateDao") 

public class TestHibernateDaoImpl { 


} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测试 方法 : 


@Test 

public void testDao() { 

TestHibernateDaoImpl dao = 

ctx.getBean("testHibernateDao", TestHibernateDaoImpl.class); 
Assert.assertNotNull(dao); 


} 
测试 成 功 说 明 被 @Repository 注 解 的 POJO 类 将 自动 被 Spring 识 别 并 注册 到 Spring 容 器 中 ， 且 
自动 支持 自动 装配 ， 并 且 被 @Repository 注 解 的 类 表示 DAO 层 实现 。 


三 、@Service : @Component 扩 展 ， 被 @Service 注 解 的 POJO 类 表示 Service 层 实现 ， 从 而 
见 到 该 注解 就 想到 Service 层 实现 ， 使 用 方式 和 @Component 相 同 ; 


1、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12.service.impl; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.beans.factory.annotation.Qualifier,; 
import org.springframework.stereotype.Service; 
import cn.javass.spring.chapter12.dao.hibernate.TestHibernateDaoImpl; 
@Service("testService") 
public class TestServiceImpl { 

@Autowired 

@Qualifier("testHibernateDao") 

private TestHibernateDaoImpJ dao; 

public TestHibernateDaoImpl] getDao() { 

return dao; 
} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测试 方法 : 


@Test 

public void testService() { 
TestServiceImpl] service = ctx.getBean("testService", TestServiceImpl.class); 
Assert.assertNotNull(service.getDao()); 


测试 成 功 说 明 被 @Service 注 解 的 POJO 类 将 自动 被 Spring 识别 并 注册 到 Spring 容器 中 ， 且 自动 
支持 自动 装配 ， 并 且 被 @Service 注 解 的 类 表示 Service 层 实现 。 


四 、@Controller : @Component 扩 展 ， 被 @Controller 注 解 的 类 表示 Web 层 实现 ， 从 而 见 
到 该 注解 就 想到 Web 层 实现 ， 使 用 方式 和 @Component 相 同 ; 


1、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12.action; 
// 省 略 import 
@Controller 
public class TestAction { 
@Autowired 
private TestServiceImpl] testService; 


public void list() { 
// 调 用 业务 逻辑 层 方法 
} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测 试 方法 : 


QTest 

public void testweb() { 
TestAction action = ctx.getBean("testAction", TestAction.class); 
Assert.assertNotNull(action); 


} 


测试 成 功 说 明 被 @Controller 注 解 的 类 将 自动 被 Spring 识别 并 注册 到 Spring 容器 中 ， 且 自动 支 
持 自动 装配 ， 并 且 被 @Controller 注 解 的 类 表示 Web 层 实现 。 


大 家 是 否 注意 到 @Controller 中 并 没有 定义 Bean 的 标识 符 ， 那 么 默认 Bean 的 名 字 将 是 以 小 写 
开头 的 类 名 (不 包括 包 名 ) ， 即 如 “TestAction”" 类 的 Bean 标 识 符 为 “testAction”。 


六 、 自 定义 扩展 : Spring 内 置 了 三 种 通用 的 扩展 注解 @Repository、@Service、 
@Controller ， 大 多 数 情况 下 没 必 要 定义 自己 的 扩展 ， 在 此 我 们 演示 下 如 何 扩展 
@Component 注 解 来 满足 某 些 特 殊 规 约 的 需要 ; 


在 此 我 们 可 能 需要 一 个 缓存 层 用 于 定义 缓存 Bean， 因 此 我 们 需要 自 定义 一 个 @Cache 的 注解 
来 表示 缓存 类 。 


1、 扩 展 @Component : 


package cn.javass.spring.chapter12.stereotype; 
// 省 略 import 
@Target({ElementType.TYPE}) 
@Retention(RetentionPolicy .RUNTIME) 
@Documented 
@Component 
public @interface Cachet{ 

String value() default ""; 
} 


扩展 十 分 简单 ， 只 需要 在 扩展 的 注解 上 注解 @Component 即 可 ，@Repository 、@Service、 
@Controller 也 是 通过 该 方式 实现 的 ， 没 什么 特别 之 处 


2、 定 义 测 试 Bean 类 : 


package cn.javass.spring.chapter12.cache; 
@Cache("cache") 
public class TestCache { 


} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测 试 方法 : 


@Test 

public void testCache() { 
TestCache cache = ctx.getBean("cache", TestCache.class); 
Assert.assertNotNull(cache); 


测试 成 功 说 明 自 定义 的 @Cache 注 解 也 能 很 好 的 工作 ， 而 且 实 现 了 我 们 的 目的 ， 使 用 @Cache 
来 表示 被 注解 的 类 是 Cache 层 Bean。 


12.3.3 JSR-250 中 定义 的 @ManagedBean 注 解 


@javax.annotation.ManagedBean 需 要 在 实现 Java EE 6 规范 的 应 用 服务 器 上 使 用 ， 虽 然 
Spring3 实 现 了 ， 但 @javax.annotation.ManagedBean 只 有 在 Java EE 6 环境 中 才 有 定义 ， 
此 测试 前 需要 我 们 定义 ManagedBean 类 。 


1、 定 义 javax.annotation.ManagedBean 注 解 类 : 


package javax.annotation; 
import java.lang.annotation.ElementType; 
import java.lang.annotation.Retention; 
import java.lang.annotation.RetentionPolicy; 
import java.lang.annotation.Target; 
@Target (ElementType.TYPE) 
@Retention(RetentionPolicy .RUNTIME) 
public @interface ManagedBean { 

String value() default ""; 
} 


其 和 @Component 完 全 相同 ， 唯 一 不 同 的 就 是 名 字 和 创建 者 (一 个 是 Spring， 一 个 是 Java EE 
规范 ) 。 


2、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12; 
import javax.annotation.Resource; 
import org.springframework.context.ApplicationContext; 
@javax.annotation.ManagedBean( "managedBean") 
public class TestManagedBean { 

Q@Resource 

private ApplicationContext ctx; 

public ApplicationContext getCtx() { 

return ctx; 
} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测 试 方法 : 


@Test 
public void testManagedBean() { 
TestManagedBean testManagedBean = ctx.getBean("managedBean", TestManagedBean.class); 


Assert.assertNotNull(testManagedBean.getctx()); 
} 
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测试 成 功 说 明 被 @ManagedBean 注 解 类 也 能 正常 工作 。 


定义 扩展 就 不 介绍 了 ， 大 家 可 以 参考 @Component 来 完成 如 图 12-2 所 示 的 自 定义 扩展 部 
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12.3.4 JSR-330 的 @Named 注 解 


@Named 不 仅 可 以 用 于 依赖 注入 来 指定 注入 的 Bean 的 标识 符 ， 还 可 以 用 于 定义 Bean。 即 注解 
在 类 型 上 表示 定义 Bean， 注 解 在 非 类 型 上 (如 字段 ) 表示 指定 依赖 注入 的 Bean 标 识 符 。 


1、 定 义 测试 Bean 类 : 


package cn.javass.spring.chapter12; 

// 省 略 import 

@Named("namedBean") 

public class TestNamedBean { 
@Inject 
private ApplicationContext ctx; 
public ApplicationContext getCtx() { 

return ctx; 


} 


2、Spring 配 置 文件 使 用 chapter12/ componentDefinitionWithAnnotation.xml 即 可 且 无 需 修 
改 ; 


3、 定 义 测 试 方法 : 


@Test 

public void testNamedBean() { 

TestNamedBean testNamedBean = 
ctx.getBean("namedBean", TestNamedBean.class); 
Assert.assertNotNull(testNamedBean.getctx()); 


测试 成 功 说 明 被 @Named 注 解 关 也 能 正常 工作 。 


定义 扩展 就 不 介绍 了 ， 大 家 可 以 参考 @Component 来 完成 如 图 12-3 所 示 的 自 定义 扩展 部 
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12.3.5 细 粒 度 控制 Bean 定 义 打 描 


在 XML 配置 中 完全 消除 了 Bean 定 义 ， 而 是 只 有 一 个 <context:component-scan> 标 签 来 支持 注 
解 Bean 定 义 扫 描 


前 边 的 示例 完全 采用 软 认 扫描 设置 ， 如 果 我 们 有 几 个 组 件 不 想 被 扫描 并 自动 注册 、 我 们 想 更 
改 黑 认 的 Bean 标 识 符 生成 策略 该 如 何 做 呢 ? 接 下 来 让 我 们 看 一 下 如 何 细 粒 度 的 控制 Bean 定 义 
扫描 ， 具 体 定 义 如 下 : 


<Context :component -scan 
base-package="" 
resource-pattern="**/*.class" 
name-generator="org.springframework.context.annotation.AnnotationBeanNameGenerato 
use-default-filters="true" 
annotation-config="true"> 
<context:include-filter type="aspect]j" expression=""/> 
<context:exclude-filter type="regex" expression=""/> 
</context:component-scan> 





。 base-package : 表示 扫描 注解 类 的 开始 位 置 ， 即 将 在 指定 的 包 中 扫描 ， 其 他 包 中 的 注解 
类 将 不 被 扫描 ， 默 认 将 扫描 所 有 类 路 径 ; 

。 resource-pattern : 表示 扫描 注解 类 的 后 缓 匹配 模式 ， 即 “base-package+resource- 
pattern” 将 组 成 匹配 模式 用 于 匹配 类 路 径 中 的 组 件 ， 默 认 后 缀 为 “Yclass”， 即 指定 包 下 的 
所 有 以 .class 结 尾 的 类 文件 ; 

。 name-generator : 默认 情况 下 的 Bean 标 识 符 生 成 策略 ， 默 认 是 
AnnotationBeanNameGenerator， 其 将 生成 以 小 写 开 头 的 类 名 (不 包括 包 名 ) ; 可 以 自 
定义 自己 的 标识 符 生成 策略 ; 

。 use-default-filters : 默认 为 true 表 示 过 滤 @Component、@ManagedBean、@Named 
注解 的 类 ， 如 果 改 为 false 默 认 将 不 过 滤 这 些 默 认 的 注解 来 定义 Bean， 即 这 些 注解 类 不 能 
被 过 滤 到 ， 即 不 能 通过 这 些 注解 进行 Bean 定 义 ; 

。 annotation-config : 表示 是 否 自 动 支持 注解 Den 注入 ， 默 认 支 持 ， 如 果 设 置 为 
false， 将 关闭 支持 注解 的 依赖 注入 ， 需 要 通过 <context:annotation-config/> 开 局 


默认 情况 下 将 自 DO \“@ManagedBean、@Named 注 解 的 类 并 将 其 注册 为 
Spring 管理 Bean， 可 以 通过 在 <context:component-scan> 标 签 中 指定 自 定 义 过 滤器 将 过 滤 到 
匹配 条 件 的 类 注册 为 Spring 管理 Bean， 具 体 定义 方式 如 下 : 


<context:include-filter type="aspect]j" expression=""/> 
<context:exclude-filter type="regex" expression=""/> 


。 <context:include-filter> : 表示 过 滤 到 的 类 将 被 注册 为 Spring 管理 Bean ; 

。 <context:exclude-filter> : 表示 过 滤 到 的 类 将 不 被 注册 为 Spring 管理 Bean， 它 比 
<context:include-filter> 具 有 更 高 优先 级 ; 

。 type 表示 过 滤器 类 型 ， 目 前 支持 注解 类 型 、 类 类 型 、 正 则 表达 式 、aspectj 表 达 式 过 滤 
器 ， 当 然 也 可 以 自 定义 自己 的 过 滤器 ， 实 现 
org.springframework.core.type.filter. TypeFilter 妈 可; 

。 expression : 表示 过 滤器 表达 式 。 


一 般 情况 下 没 必要 进行 自 定义 过 滤 ， 如 果 需 要 请 参考 如 下 示例 : 
1、cn.javass.spring.chapter12.TestBean14 自 动 注 册 为 Spring 管理 Bean : 


<context:include-filter type="assignable" expression="cn.javass.spring.chapter12.TestBean 
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2、 把 所 有 注解 为 org.aspectj.lang.annotation.Aspect 自 动 注册 为 Spring 管 理 Bean : 


<context:include-filter type="annotation" 
expression="org.aspectj.lang.annotation.Aspect"/> 


3、 将 把 匹配 到 正则 表达 式 “cn.javass.spring.chapter12.TestBean2*” 排 除 ， 不 注册 为 Spring 管 
理 Bean : 


<context:exclude-filter type="regex" expression="cn\.javass\.spring\.chapter12\.TestBean2 
和 


4、 将 把 匹配 到 aspectj 表 达 式 “cn.javass.spring.chapter12.TestBean3*” 排 除 ， 不 注册 为 Spring 
管理 Bean : 





<context:exclude-filter type="aspectj" expression="cn.javass.spring.chapter12.TestBean3*" 





具体 使 用 就 要 看 项 目 需要 了 ， 如 果 以 上 都 不 满足 需要 请 考虑 使 用 自 定义 过 滤器 。 


12.3.6 提供 更 多 的 配置 元 数据 
1、@Lazy : 定义 Bean 将 延迟 初始 化 ， 使 用 方式 如 下 : 


@Component ("component") 
@Lazy(true) 
public class TestCompoment { 


使 用 @Lazy 注 解 指 定 Bean 需 要 延迟 初始 化 。 


2、@DependsOn : 定义 Bean 初 始 化 及 销毁 时 的 顺序 ， 使 用 方式 如 下 : 
@Component ("component") 


@Dependson({"managedBean"}) 
public class TestCompoment { 


3、@Scope : 定义 Bean 作 用 域 ， 上 默认 单 例 ， 使 用 方式 如 下 : 


@Component ("component") 
@sScope("singleton") 
public class TestCompoment { 


4、@Qualifier : 指定 限定 描述 符 ， 对 应 于 基于 XML 配置 中 的 <qualifier> 标 签 ， 使 用 方式 如 


@Component ("component") 
@Qualifier("component") 
public class TestCompoment { 


可 以 使 用 复杂 的 扩展 ， 如 @Mysql 等 等 。 


5、@Primary : 自动 装配 时 当 出 现 多 个 Bean 候 选 者 时 ， 被 注解 为 @Primary 的 Bean 将 作为 首 
选 者 ， 否 则 将 抛 出 异常 ， 使 用 方式 如 下 : 


@Component ("component " ) 
@Primary 
public class TestCompoment { 


原创 内 容 ， 转 载 请 注 明 私 部 在 线 【http://sishuok.com/forum/blogPost/list/2547.html] 


[第 十 二 章 】 零 配置 之 12.4 基于 Java 类 定义 Bean 
配 数 # 
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12.4 基于 Java 类 定义 Bean 配 置 元 数据 


12.4.1 概述 


基于 Java 类 定义 Bean 配 置 元 数据 ， 其 实 就 是 通过 Java 类 定义 Spring 配置 元 数据 ， 且 直接 消除 
XML 配置 文件 。 


基于 Java 类 定义 Bean 配 置 元 数据 中 的 @Configuration 注 解 的 类 等 价 于 XML 配置 文件 ，@Bean 
注解 的 方法 等 价 于 XML 配置 文件 中 的 Bean 定 义 。 


基于 Java 类 定义 Bean 配 置 元 数据 需要 通过 AnnotationConfigApplicationContext 加 载 配置 类 及 
初始 化 容器 ， 类 似 于 XML 配置 文件 需要 使 用 ClassPathXmlApplicationContext 加 载 配置 文件 及 
初始 化 容器 


基于 Java 类 定义 Bean 配 置 元 数据 需要 CGLIB 的 支持 ， 因 此 要 保证 类 路 径 中 包括 CGLIB 的 jar 


所 。 


12.4.2 Hello World 

首先 让 我 们 看 一 下 基于 Java 类 如 何 定义 Bean 配 置 元 数据 ， 具 体 步骤 如 下 : 

1、 通 过 @Configuration 注 解 需要 作为 配置 的 类 ， 表 示 该 类 将 定义 Bean 配 置 元 数据 ; 

2、 通 过 @Bean 注 解 相 应 的 方法 ， 该 方法 名 默认 就 是 Bean 名 ， 该 方法 返回 值 就 是 Bean 对 象 ; 
3、 通 过 AnnotationConfigApplicationContext 或 子 类 加 载 基 于 Java 类 的 配置 

接 下 来 让 我 们 先 来 学 习 一 下 如 何 通过 Java 类 定义 Bean 配 置 元 数据 吧 : 


1、 定 义 配 置 元 数据 的 Java 类 如 下 所 示 : 


package cn.javass.spring.chapter12.configuration; 
Import org.springframework.context.annotation.Bean,; 
Import org.springframework.context.annotation.Configuration; 
Q@Cconfiguration 
public class ApplicationContextConfig { 

Q@Bean 

public String message() { 

return "hello"; 
} 


} 


2、 定 义 测试 类 ， 测 试 一 下 Java 配 置 类 是 否 工 作 : 


package cn.javass.spring.chapter12.configuration; 
// 省 略 import 
public class ConfigurationTest { 
@Test 
public void testHelloworld () { 
AnnotationCconfigApplicationContext ctx = new AnnotationConfigApplicationContext(A 
Assert.assertEquals("hello", ctx.getBean("message")); 


} 
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测试 没有 报错 说 明 测 试 通过 了 “， 那 AnnotationConfigApplicationContext 是 如 何 工作 的 呢 ， 接 
下 来 让 我 们 分 析 一 下 : 


e 使 用 @ooniguratons 配置 类 ， 该 配置 类 定义 了 Bean 配 置 元 数据 ; 

。 使 用 @Bean 注 解 配置 类 中 的 方法 ， 该 方法 名 就 是 Bean 的 名 字 ， 该 方法 返回 值 就 是 Bean 
对 象 。 

。 使 用 new AnnotationConfigApplicationContext(ApplicationContextConfig.class) 创 建 应 用 
上 下 文 ， 构 造 器 参数 为 使 用 @Configuration 注 解 的 配置 类 ， 读 取 配 置 类 进行 实例 化 相应 
的 Bean 。 


道 如 何 使 用 了 ， 接 下 来 就 详细 介绍 每 个 部 分 吧 。 


12.4.3 @Configuration 


通过 @Configuration 注 解 的 类 将 被 作为 配置 类 使 用 ， 表 示 在 该 类 中 将 定义 Bean 配 置 元 数据 ， 
且 使 用 @Configuration 注 解 的 类 本 身 也 是 一 个 Bean， 使 用 方式 如 下 所 示 : 


import org.springframework.context.annotation.Configuration; 
@Configuration("ctxConfig") 
public class ApplicationContextConfig { 
// 定 义 Bean 配 置 元 数据 
} 


为 使 用 @Configuration 注 解 的 类 本 身 也 是 一 个 Bean， 因 为 @Configuration 被 @Component 
注解 了 ， 因 此 @Configuration 注 解 可 以 指定 value 属 性 值 ， 如 “ctxConfig" 就 是 该 Bean 的 名 字 ， 
如 使 用 “ctx.getBean("ctxConfig") 将 返回 该 Bean。 


使 用 @Configuration 注 解 的 类 不 能 是 final 的 ， 且 应 该 有 一 个 默认 无 参 构 造 器 。 


12.4.4 @Bean 


过 @Bean 注 解 配 置 类 中 的 相应 方法 ， 则 该 方法 名 默认 就 是 Bean 名 ， 该 方法 返回 值 就 是 
Be 并 定义 了 Spring loC 容 器 如 何 实例 化 、 自 动 装配 、 初 始 化 Bean 人 逻辑 ， 具 体 使 用 方 
法 如 下 : 。 


@Bean(name={}, 
autowire=Autowire.No, 
initMethod="", 
destroyMethod="") 


。 name : 指定 Bean 的 名 字 ， 可 有 多 个 ， 第 一 个 作为 Ild， 其 他 作为 别名 

。 autowire : 自动 装配 ， 默 认 no 表 示 不 自动 装配 该 Bean， 另 外 还 ao BY_NAME 表 
示 根 据 名 字 自 动 装配 ，Autowire.BY_TYPE 表 示 根 据 类 型 自动 装配 ; 

。 initMethod 和 destroyMethod : 指定 Bean 的 初始 化 和 销毁 方法 。 


示例 如 下 所 示 (ApplicationContextConfig.java) 


@Bean 
public String message() { 
return new String("hello"); 


如 上 使 用 方式 等 价 于 如 下 基于 XML 配置 方式 


<bean id="message" class="java.lang.Sstring"> 
<constructor-arg index="0" value="hello"/> 
</bean> 


使 用 @Bean 注 解 的 方法 不 能 是 private、final 或 static 的 。 


12.4.5 提供 更 多 的 配置 元 数据 
见 【12.3.6 提供 更 多 的 配置 元 数据 】 中 介绍 的 各 种 注解 ， 这 些 注 解 同样 适用 于 @Bean 注 解 
ee 9 
12.4.6 依赖 注入 
基于 Java 类 配置 方式 的 Bean 依 赖 注入 有 如 下 两 种 方式 : 


。 直接 依赖 注入 ， 类 似 于 基于 XML 配置 方式 中 的 显示 依赖 注入 ; 
。 使 用 注解 实现 Bean 依 赖 注 入 : 如 @Autowired 等 等 。 


在 本 示例 中 我 们 将 使 用 【第 三 章 DI】 中 的 测试 Bean 。 
直接 依赖 注入 : 包括 构造 器 注入 和 setter 注 入 。 


。 构造 器 注入 : 通过 在 @Bean 注 解 的 实例 化 方法 中 使 用 有 参 构 造 器 实例 化 相应 的 Bean 即 
到 ee : 


@Bean 
public HelloApi helloImpl3() { 
// 通 过 构造 器 注入 ,分 别 是 引用 注入 (message()) 和 常量 注入 (1) 
return new HelloImpl3(message()，14); // 测 试 Bean 详 见 【3.1.2 构造 器 注入 】 


。 setter 注 入 : 通过 在 @Bean 注 解 的 实例 化 方法 中 使 用 无 参 构造 器 实例 化 后 ， 通 过 相应 的 
setter 方 法 注入 即 可 ， 如 下 所 示 (ApplicationContextConfig.java): 


@Bean 
public HelloApi helloImpl14() { 
HelloImpl4 helloImpl4 = new HelloImp14();// 测 试 Bean 详 见 【3.1.3 setter 注 入 】 
// 通 过 setter 注 入 注入 引用 
helloImpl4.setMessage(message()); 
// 通 过 setter 注 入 注入 常量 
helloImpl14.setIindex(1); 
return helloImpl14; 


2、 使 用 注解 实现 Bean 依 赖 注入 : 详 见 【12.2 注解 实 Bean 依 赖 注入 】。 


具体 测试 方法 如 下 (ConfigurationTest.java) : 


@Test 

public void testDependencyInject() { 
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Appli 
ctx.getBean("helloImpl3", HelloApi.class).sayHello(); 
ctx.getBean("helloImpl4", HelloApi.class).sayHello(); 


I 





| 
12.4.7 方法 注入 


在 基于 XML 配置 方式 中 ，Spring 支 持 查找 方法 注入 和 替换 方法 注入 ， 但 在 基于 Java 配 置 方式 
中 只 支持 查找 方法 注入 ， 一 般 用 于 在 一 个 单 例 Bean 中 注入 一 个 原型 Bean 的 情况 ， 具 体 详 见 
【3.3.5 方法 注入 】， 如 下 所 示 (ApplicationContextConfig.java ) 


Q@Bean 
@sScope("singleton") 
public HelloApi helloApi2() { 
HelloImpl5 helloImpl5 = new HelloImpl5() { 
@Override 
public Printer createPrototypePrinter() { 
// 方 法 注入 ， 注 入 原型 Bean 
return prototypePrinter(); 
} 
Q@Override 
public Printer createSingletonpPrinter() { 
// 方 法 注入 ， 注 入 单 例 Bean 
return singletonPrinter(); 


} 
}; 
// 依 赖 注 入 , 注入 单 例 Bean 
helloImpl5.setPrinter(singletonpPrinter()); 
return helloImpls; 


@Bean 
@sScope(value="prototype") 
public Printer prototypePrinter() { 
return new Printer(); 
} 


@Bean 

@sScope(value="singleton") 

public Printer SingletonPrinter() { 
return new Printer(); 

} 


具体 测试 方法 如 下 (ConfigurationTest.java) : 


@Test 
public void testLookupMethodInject() { 
AnnotationCconfigApplicationContext ctx = 
new AnnotationConfigApplicationContext(ApplicationContextConfig.class); 
System.out.println("=======prototype sayHello======")， 
HelloApi helloApi2 = ctx.getBean("helloApi2", HelloApi.class); 
helloApi2.sayHello( ); 
helloApi2 = ctx.getBean("helloApi2", HelloApi.class); 
helloApi2.sayHello(); 


如 上 测试 等 价 于 【3.3.5 方法 注入 】 中 的 查找 方法 注入 。 


12.4.8 @Import 


类 似 于 基于 XML 配置 中 的 <import/>， 基 于 Java 的 配置 方式 提供 了 @Import 来 组 合 模块 化 的 配 


四 
置 类 ， 使 用 方式 如 下 所 示 : 


package cn.javass.spring.chapter12.configuration; 
// 省 略 import 
@Configuration("ctxConfig2") 
@Import({ApplicationContextConfig.class}) 
public class ApplicationContextConfig2 { 

@Bean(name = {"message2"}) 

public String message() { 

return "hello"; 
} 


具体 测试 方法 如 下 (ConfigurationTest.java) : 


@Test 
public void importTest() { 


AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Appli 


Assert.assertEquals("hello", ctx.getBean("message")); 


] 
ES 


使 用 非常 简单 ， 在 此 就 不 多 介绍 了 。 


12.4.9 结合 基于 Java 和 基于 XML 方式 的 配置 





基于 Java 方 式 的 配置 方式 不 是 为 了 完全 替代 基于 XML 方式 的 配置 ， 两 者 可 以 结合 使 用 ， 因 此 
可 以 有 两 种 结合 使 用 方式 : 


。 在 基于 Java 方 式 的 配置 类 中 引入 基于 XML 方式 的 配置 文件 ; 
。 在 基于 XML 方式 的 配置 文件 中 中 引入 基于 Java 方 式 的 配置 。 


一 、 在 基于 Java 方 式 的 配置 类 中 引入 基于 XML 方式 的 配置 文件 : 在 @Configuration 注 解 的 配 
置 类 上 通过 @ImportResource 注 解 引入 基于 XML 方式 的 配置 文件 ， 示 例如 下 所 示 : 


1、 定 义 基 于 XML 方式 的 配置 文件 (chapter12/configuratiom/importResource.xml) : 


<bean id="message3" class="java.lang.Sstring"> 
<constructor-arg index="0" value="test"></constructor-arg> 
</bean> 


2、 修 改 基 于 Java 方 式 的 配置 类 ApplicationContextConfig， 添 加 如 下 注解 : 


@Configuration("ctxConfig") //1、 使 用 @Configuration 注 解 配 置 类 
@ImportResource("classpath:chapter12/configuration/importResource.xml") 
public class ApplicationContextConfig { 


使 用 @ImportResource 引 入 基于 XML 方式 的 配置 文件 ， 如 果 有 多 个 请 使 用 
@ImportResource({"config1.xml", "config2.xml")) 方 式 指定 多 个 配置 文件 。 


二 、 在 基于 XML 方式 的 配置 文件 中 中 引入 基于 Java 方 式 的 配置 : 直接 在 XML 配置 文件 中 声明 
使 用 @Configuration 注 解 的 配置 类 即 可 ， 示 例如 下 所 示 : 


1、 定 义 基 于 Java 方 式 的 使 用 @Configuration 注 解 的 配置 类 在 此 我 们 使 用 
ApplicationContextConfig.java ° 


2、 定 义 基 于 XML 方式 的 配置 文件 (chapter12/configuration/xml-config.xml) 


<context:annotation-config/> 
<bean id="ctxConfig" class="cn.]javass.spring.chapter12.configuration.ApplicationContextCo 





。 <context:annotation-config/> : 用 于 开启 对 注解 驱动 支持 ， 详 见 【12.2 注解 实现 Bean 依 
赖 注入 】 ; 

。 <bean id="ctxConfig" class="......"/> : 直接 将 使 用 @Configuration 注 解 的 配置 类 在 配置 
文件 中 进行 Bean 定 义 即 可 。 


3、 测 试 代码 如 下 所 示 (ConfigurationTest.java) : : 


public void testxmlConfig() { 
String configLocations[] = {"chapter12/configuration/xml-config.xml"}; 
ApplicationContext ctx = new ClassPathxmlApplicationContext(configLocations); 
Assert.assertEquals("hello", ctx.getBean("message")); 


测试 成 功 ， 说 明 通 过 在 基于 XML 方式 的 配置 文件 中 能 获取 到 基于 Java 方 式 的 配置 文件 中 定义 
的 Bean， 如 “message”Bean 。 


12.4.10 基于 Java 方 式 的 容器 实例 化 


基于 Java 方 式 的 容器 由 AnnotationConfigApplicationContext 表 示 ， 其 实例 化 方式 主要 有 以 下 
几 种 : 


一 、 对 于 只 有 一 个 @Configuration 注 解 的 配置 类 ， 可 以 使 用 如 下 方式 初始 化 容器 : 


AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(Applicati 
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二 、 对 于 有 多 个 @Configuration 注 解 的 配置 类 ， 可 以 使 用 如 下 方式 初始 化 容器 : 


AnnotationConfigApplicationContext ctx1 = new AnnotationConfigApplicationContext(Applicat 
ss = 





AnnotationConfigApplicationContext ctx2 = new AnnotationConfigApplicationContext(); 
ctx2.register(ApplicationContextConfig.class); 
ctx2.register(ApplicationContextConfig2.class); 


三 、 对 于 【12.3 注解 实现 Bean 定 义 】 中 通过 扫描 类 路 径 中 的 特殊 注解 类 来 自动 注册 Bean 定 
义 ， 可 以 使 用 如 下 方式 来 实现 : 


public void testComponentScan() { 
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext(); 
ctx.scan("cn.javass.chapter12.confiuration"); 
ctx.refresh(); 
Assert.assertEquals("hello", ctx.getBean("message")); 


以 上 配置 方式 等 价 于 基于 XML 方式 中 的 如 下 配置 


<context:component-scan base-package="cn.javass.chapter12.confiuration"/> 


四 、 在 web 环境 中 使 用 基于 Java 方 式 的 配置 ， 通 过 修改 通用 配置 实现 ， 详 见 【10.1.2 通 用 配 
置 】 


1、 修 改 通用 配置 中 的 Web 应 用 上 下 文 实现 ， 在 此 需要 使 用 
AnnotationConfigWebApplicationContext : 


<context-param> 
<param-name>contextClass</param-name> 


<param-value> 
org.springframework.web.context.support.AnnotationConfigwebApplicationContext 


</param-value> 
</context-param> 


、 指 定 加 载 配置 类 ， 类 似 于 指定 加 载 文 件 位 置 ， 在 基于 Java 方 式 中 需要 指定 需要 加 载 的 配置 


2 
类 ， 


<context-param> 
<param-name>contextConfigLocation</param-name> 


<param-value> 
cn.javass.spring.chapter12.configuration.ApplicationContextConfig, 
cn.javass.spring.chapter12.configuration.ApplicationContextConfig2 
</param-value> 
</context-param> 


。 contextConfigLocation : 除了 可 以 指定 配置 类 ， 还 可 以 指定 “扫描 的 类 路 径 ”， 其 加 载 步 
又 如 下 : 


1、 首 先 验证 指定 的 配置 是 否 是 类 ， 如 果 是 则 通过 注册 配置 类 来 完成 Bean 定 义 加 载 ， 即 如 通过 
ctx.register(ApplicationContextConfig.class) 加 载 定义 ; 


2、 如 果 指 定 的 配置 不 是 类 ， 则 通过 扫描 类 路 径 方式 加 载 注 解 Bean 定 义 ， 即 将 通 
ctx.scan("cn.javass.chapter12.confiuration") 加 载 Bean 定 义 。 


原创 内 容 ， 转 载 请 注 明 私 整 在 线 【http://sishuok.com/forum/blogPost/list0/2550.htmlj】 


【第 十 二 章 】 零 配置 之 12.5 综合 示例 -积分 商城 
一 一 跟 我 学 spring3 


12.5 综合 示例 


12.5.1 概述 


在 第 十 一 章 中 我 们 介绍 了 SSH 集 成 ， 在 进行 SSH 集 成 时 都 是 通过 基于 XML 配置 文件 配置 每 层 
的 Bean， 从 而 产生 许多 XML 配置 文件 ， 本 节 将 通过 注解 方式 消除 部 分 XML 配置 文件 ， 实 现 所 
谓 的 零 配 置 。 


12.5.2 项 目 拷 贝 
1、 拷 贝 【第 十 一 章 SSH 集 成 开发 】 中 的 “pointShop” 项 目 将 其 命名 为 “pointShop2”; 


2、 修 改 “pointShop2” 项 目下 的 “.settings" 文 件 夹 下 的 “org.eclipse.wst.common.component" 文 
件 ， 将 “<property name="context-root" value="pointShop"/>” 修 改 为 “<property 
name="context-root" value="pointShop2"/>”， 即 该 web 项 目的 上 下 文 为 "pointShop2”， 在 
浏览 器 中 可 以 通过 http://localhost:8080/pointShop2 来 访问 该 Web 项 目 。 


12.5.3 数据 访问 层 变 化 


将 dao 层 配置 文件 中 的 dao 实 现 Bean 定 义 删 除 ， 通 过 在 dao 实 现 类 头 上 添加 “@Repository”" 来 定 
义 dao 实 现 Bean， 并 通过 注解 @Autowired 来 完成 依赖 注入 。 


1、 删 除 DAO 层 配置 文件 (cmjavass/point/dao/applicationContext-hibernate.xml) 中 的 如 下 配 
置 : 


<bean id="abstractDao" abstract="true" init-method="init"> 

<property name="sessionFactory" ref="sessionFactory"/> 

</bean> 

<bean id="goodsDao" class="cn.javass.point.dao.hibernate.GoodsHibernateDao" 
parent="abstractDao"/> 

<bean id="goodsCodeDao" class="cn.javass.point.dao.hibernate.GoodsCodeHibernateDao" 
parent="abstractDao"/> 





2、 修 改 通 用 DAO 实 现 cn.javass.commons.dao.hibernate.BaseHibernateDao， 通 过 注解 实现 
依赖 注入 和 指定 初始 化 方法 : 


public abstract class BaseHibernateDao<M extends Serializable, PK extends Serializable> e 
// 省 略 类 字段 
@Autowired @Required 
public void setsf(SessionFactory sf) { 
setSessionFactory(sf); 


@PostConstruct 
@Suppresswarnings("unchecked") 
public void init() { 

// 省 略 具体 实现 代码 
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。 setSf 方 法 : 通过 @Autowired 注 解 自 动 注入 SessionFactory 实 现 ; 
einit 方 法 : 通过 @PostConstruct 注 解 表示 该 方法 是 初始 化 方法 ; 


3、 修 改 cn.javass.point.dao.hibernate.GoodsHibernateDao， 在 该 类 上 添加 @Repository 注 解 
来 进行 DAO 层 Bean 定 义 : 


@Repository 
public class GoodsHibernateDao extends BaseHibernateDao<GoodsModel, Integer> implements I 





4、 修 改 cn.javass.point.dao.hibernate.GoodsCodeHibernateDao， 在 该 类 上 添加 
@Repository 注 解 来 进行 DAO 层 Bean 定 义 : 


@Repository 
public class GoodsCodeHibernateDao extends BaseHibernateDao<GoodsCodeModel, Integer> impl 





DAO 层 到 此 就 修改 完毕 ， 其 他 地 方 无 需 修改 。 


12.5.4 业务 逻辑 层 变 化 


将 service 层 配置 文件 中 的 service 实 现 Bean 定 义 删 除 ， 通 过 在 service 实 现 类 头 上 添 
加 “@Service” 来 定义 service 实 现 Bean， 并 通过 注解 @Autowired 来 完成 依赖 注入 。 


1、 删 除 Service 层 配置 文件 (cn/javass/point/service/applicationContext-service.xml) 中 的 如 下 
配置 


<bean id="goodsService" class="cn.javass.point.service.impl.GoodsServiceImpl"> 
<property name="dao" ref="goodsDao"/> 

</bean> 

<bean id="goodsCodeService" class="cn.javass.point.service.impl.GoodsCodeServiceImpl"> 
<property name="dao" ref="goodsCodeDao"/> 
<property name="goodsService" ref="goodsService"/> 

</bean> 


2、 修 改 cnjavass.point.service.impl.GoodsServicelmpl， 在 该 类 上 添加 @Service 注 解 来 进 和 
Service 层 Bean 定 义 : 


@Service 
public class GoodsServiceImpl extends BaseServiceImpl<GoodsModel, Integer> implements IGo 


@Autowired @Required 

public void setGoodsDao(IGoodsDao dao) { 
setDao(dao); 

} 








。 setGoodsDao 方 法 : 用 于 注入 I|GoodsDao 实 现 ， 此 处 直接 委托 给 setDao 方 法 。 


3、 修 改 cn.javass.point.service.impl.GoodsCodeServicelmpl， 在 该 类 上 添加 @Service 注 解 来 
进行 Service 层 Bean 定 义 : 


@Service 
public class GoodsCodeServiceImpl extends BaseServiceImpl<GoodsCodeModel, Integer> implem 
@Autowired @Required 
public void setGoodsCodeDao(IGoodsCodeDao dao) { 
setDao(dao); 


@Autowired @Required 
public void setGoodsService(IGoodsService goodsService) { 
this.goodsService = goodsService; 





。 setGoodsCodeDao 方 法 : 用 于 注入 |GoodsCodeDao 实 现 ， 此 处 直接 委托 给 setDao 方 
法 ; 
。 setGoodsService 方 法 : 用 于 注入 |GoodsService 实 现 。 


Service 层 到 此 就 修改 完毕 ， 其 他 地 方 无 需 修 改 。 


12.5.5 表现 层 变化 


类 似 于 数据 访问 层 和 业务 逻辑 层 修改 ， 对 于 表现 层 配 置 文件 直接 删除 ， 通 过 在 action 实 现 类 头 
上 添加 “@Controller" 来 定义 action 实 现 Bean， 并 通过 注解 @Autowired 来 完成 依赖 注入 。 


1、 删除 表现 层 所 有 Spring 配 置 文件 (cn/javass/point/web) : 


cn/javass/point/web/pointShop-admin-servlet.xml 
cn/javass/point/web/pointShop-front-servlet.xml 


2、 修 改 表现 层 管 理 模块 的 cn.javass.point.web.admin.action.GoodsAction， 在 该 类 上 添加 
@Controller 注 解 来 进行 表现 层 Bean 定 义 ， 且 作用 域 为 “prototype” 


@Controller("/admin/goodsAction") 
@sScope("prototype") 
public class GoodsAction extends BaseAction { 
private IGoodsService goodsService; 
@Autowired @Required 
public void setGoodsService(IGoodsService goodsService) { 
this.goodsService = goodsService; 
} 


。 setGoodsService 方 法 : 用 于 注入 |GoodsService 实 现 。 


3、 修 改 表现 层 管理 模块 的 cn.javass.point.web.admin.action.GoodsCodeAction， 在 该 类 上 添 
加 @Controller 注 解 来 进行 表现 层 Bean 定 义 ， 且 作用 域 为 “prototype”: 


@Controller("/admin/goodsCodeAction") 
@sScope("prototype") 
public class GoodsCodeAction extends BaseAction { 
@Autowired @Required 
public void setGoodsCodeService(IGoodsCodeService goodsCodeService) { 
this.goodsCodeService = goodsCodeService; 


@Autowired @Required 

public void setGoodsService(IGoodsService goodsService) { 
this.goodsService = goodsService; 

} 


。 setGoodsCodeService 方 法 : 用 于 注入 I|GoodsCodeService 实 现 ; 
。 setGoodsService 方 法 : 用 于 注入 |GoodsService 实 现 。 


3、 修 改 表现 层 前 人 台 模 块 的 cn.javass.point.web.front.action.GoodsAction， 在 该 类 上 添加 
@Controller 注 解 来 进行 表现 层 Bean 定 义 ， 且 作用 域 为 “prototype”: 


@Controller("/front/goodsAction") 
@sScope("prototype") 
public class GoodsAction extends BaseAction { 
@Autowired @Required 
public void setGoodsService(IGoodsService goodsService) { 
this.goodsService = goodsService; 


@Autowired @Required 

public void setGoodsCodeService(IGoodsCodeService goodsCodeService) { 
this.goodsCodeService = goodsCodeService; 

} 


。 setGoodsCodeService 方 法 : 用 于 注入 IGoodsCodeService 实 现 ; 
e setGoodsService 方 法 : 用 于 注入 |GoodsService 实 现 。 


12.5.6 其 他 变化 


1、 定 义 一 个 基于 Java 方 法 的 配置 类 ， 用 于 加 载 XML 配 置 文件 : 


package cn.javass.point; 
Import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.ImportResource; 
@Configuration 
@ImportResource( 
{"classpath:applicationContext-resources.xml", 
"classpath:cn/javass/point/dao/applicationContext-hibernate.xml", 
"classpath:cn/javass/point/service/applicationContext-service.xml" 


) 
public class AppConfig { 
} 


人 于 加 载 零 配置 中 一 般 不 变 的 XML 配置 文件 ， 如 事务 管理 ， 数 据 源 、SessionFactory ， 
这 些 在 几乎 所 有 项 目 中 都 是 类 似 的 ， 因 此 可 以 作为 通用 配置 。 


2、 修 改 集成 其 它 Web 框 架 的 通用 配置 ， 将 如 下 配置 : 


<Context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value> 
classpath:applicationContext-resources.xml, 
classpath:cn/javass/point/dao/applicationContext-hibernate.xml, 
classpath:cn/javass/point/service/applicationContext-service.xml, 
classpath:cn/javass/point/web/pointShop-admin-servlet.xml, 
classpath:cn/javass/point/web/pointShop-front-servlet.xml 
</param-value> 
</context-param> 


修改 为 如 下 配置 


<Context-param> 
<param-name>contextClass</param-name> 
<param-value> 
org.springframework .web.context.support.AnnotationCconfigwebApplicationContext 
</param-value> 
</context-param> 
<context-param> 
<param-name>contextCconfigLocation</param-name> 
<param-value>cn.javass.point</param-value> 
</context-param> 


1 | 


。 contextClass : 使 用 notationConfigWebApplicationContext 替 换 默 认 的 
XmlWebApplicationContext ; 

。 contextConfigLocation : 指定 为 “cn.javass.point”， 表 示 将 通过 扫描 该 类 路 
径 “cn.javass.point* 下 的 注解 类 来 进行 加 载 Bean 定 义 。 


启动 pointShop2 项 目 ， 在 浏览 器 输入 http://localhost:8080/pointShop2/admin/goodsl/list.action 
访问 积分 商城 后 台 ， 如 果 没 问题 说 明 零 配置 整合 成 功 。 


到 此 零 配 置 方式 实现 SSH 集 成 已 经 整合 完毕 ， 相 对 于 基于 XML 方式 主要 减少 了 配置 的 数量 和 
置 文件 的 数量 。 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/2553.html]】 


【第 十 三 章 】 测试 之 13.1 概述 13.2 单元 测试 
一 一 跟 我 学 spring3 


13.1 概述 


13.1.1 测 会 


软件 测试 的 目的 首先 是 为 了 保证 软件 功能 的 正确 性 ， 其 次 是 为 了 保证 软件 的 质量 ， 和 软件 测试 
相当 复杂 ， 已 经 超出 本 书 所 涉及 的 范围 ， 本 节 将 只 介绍 软件 测试 流程 中 前 两 个 步骤 : 单元 测 
试 和 集成 测试 。 

Spring 提供 了 专门 的 测试 模块 用 于 简化 单元 测试 和 集成 测试 ， 单 元 测试 和 集成 测试 一 般 由 程序 
员 实现 。 


13.2 单元 测试 


13.2.1 概述 

单元 测试 是 最 细 粒 度 的 测试 ， 即 具有 原子 性 ， 通 常 测试 的 是 某 个 功能 (如 测试 类 中 的 茶 个 方 
法 的 功能 ) 。 

采用 依赖 注入 后 我 们 的 代码 对 Spring loC 容 器 
时 无 需 依 赖 Spring loC 容 器 ， 我 们 只 需要 通过 简 
来 测试 该 方法 是 否 完成 我 们 预期 的 功能 。 


几乎 没有 任何 依赖 ， 因 此 在 对 我 们 代码 进行 测试 
简单 的 实例 化 对 象 、 注 入 依赖 然后 测试 相应 方法 


在 本 书 中 使 用 的 传统 开发 流程 ， 即 先 编写 代码 实现 功能 ， 然 后 再 写 测试 来 验证 功能 是 否 
确 ， 而 不 是 测试 驱动 开发 ， 测 试 驱动 开发 是 指 在 编写 代码 实现 功能 之 前 先 写 测试 ， 然 后 再 根 
据 测 试 来 写 满足 测试 要 求 的 功能 代码 ， 通 过 测试 来 驱动 开发 ， 如 果 对 测试 驱动 开发 感 兴趣 推 
荐 阅读 【测试 驱动 开发 的 艺术 】 。 
在 实际 工作 中 ， 应 该 只 对 一 些 复杂 的 功能 进行 单元 测试 ， 对 于 一 些 简单 的 功能 (如 数据 访问 
层 的 CRUD ) 没有 必要 花费 时 间 进 行 单元 测试 。 
Spring 对 单元 测试 提供 如 下 支持 : 

e。 Mock 对 象 : Spring 通过 Mock 对 象 来 简化 一 些 场景 的 单元 测试 : 


JNDI 测 试 支持 : 在 org.springframework.mock.jndi 包 下 通过 了 SimpleNamingContextBuilder 来 
来 创建 JNDI 上 下 文 Mock 对 象 ， 从 而 无 需 依 赖 特定 Java EE 容器 即 可 完成 JNDI 测 试 。 


Web 测试 支持 : 在 org.springframework.mock.web 包 中 提供 了 一 组 Servlet API 的 Mock 对 象 ， 
从 而 可 以 无 需 Web 容 器 即 可 测试 Web 层 的 类 。 


。 工具 类 : 通过 通用 的 工具 类 来 简化 编写 测试 代码 : 


反射 工具 类 : 在 org.springframework.test.util 包 下 的 ReflectionTestUtils 能 通过 反射 完成 类 的 非 
public 字 段 或 setter 方 法 的 调用 ; 


JDBC 工 具 类 : 在 org.springframework.test.util 包 下 的 SimpleJdbcTestUtils 能 读 取 一 个 sql 脚 本 
文件 并 执行 来 简化 SQL 的 执行 ， 还 提供 了 如 清空 表 、 统 计 表 中 行 数 的 简便 方法 来 简化 测试 代 
码 的 编写 。 


接 下 来 让 我 们 学 习 一 下 开发 过 程 中 各 层 代码 如 何 编写 测试 用 例 。 


13.2.2 准备 测试 环境 


1、Junit 安 装 : 将 Junit 4 包 添 加 到 “pointShop” 项 目 中 ， 具 体 方 法 请 参照 【2.2.3 Hello 
World】 。 


2、jMock 安 装 : 到 jMock 官 网 【http://www.jmock.org/】 下 载 最 新 的 jMlock 包 ， 在 本 书 中 使 用 
jMock2.5.1 版 本 ， 将 下 载 的 "mock-2.5.1-jars.zip ” 包 中 的 如 下 jar 包 拷贝 到 项 目的 |ib 目 录 下 并 添 
加 到 类 路 径 : 


e。 objenesis-1.0.jar 

。 jmock-script-2.5.1.jar 

。 jmock-legacy-2.5.1.jar 
e。 jmock-junit4-2.5.1.jar 
。 jmock-junit3-2.5.1.jar 
e。 jmock-2.5.1.jar 

。 hamcrest-library-1.1.jar 
。 hamcrest-core-1.1.jar 

e bsh-core-2.0b4.jar 


注 : cglib 包 无 需 添加 到 类 路 径 ， 因 为 我 们 之 前 已 经 提供 。 


3、 添 加 Spring 测试 支持 包 : 将 下 载 的 spring-framework-3.0.5.RELEASE-with-docs.zip 包 中 
的 如 下 jar 包 拷贝 到 项 目的 lib 目 录 下 并 添加 到 类 路 径 : 


dist\org.springframework.test-3.0.5.RELEASE.jar 


4、 在 “pointShop” 项 目下 新 建 test 文 件 夹 并 将 其 添加 到 【Java Build Path】 中 ， 该 文件 夹 用 于 
存放 测试 代码 ， 从 而 分 离 测试 代码 和 开发 代码 。 


到 此 测试 环境 搭建 完毕 。 


13.2.3 数据 访问 层 


数据 访问 层 单元 测试 ， 目 的 是 测试 该 层 定 义 的 接口 实现 方法 的 行为 是 否 正确 ， 


其 实 本 质 是 测 


试 是 否 正 确 与 数据 库 交互 ， 是 否 发 送 并 执行 了 正确 的 SQL ，SQL 执 行 成 功 后 是 否 正 确 的 组 装 


了 业务 逻辑 层 需要 的 数据 。 
数据 访问 层 单元 测试 通过 Mock 对 象 与 数据 库 交 互 的 AP| 来 完成 测试 。 
接 下 来 让 我 们 学 习 一 下 如 何 进行 数据 访问 层 单元 测试 : 


1、 在 test 文 件 夹 下 创建 如 下 测试 类 : 


package cn.javass.point.dao.hibernate; 
// 省 略 import 
public class GoodsHibernateDaoUnitTest { 
//1、Mock 对 象 上 下 文 ， 用 于 创建 Mock 对 象 
private final Mockery context = new Mockery() {{ 
//1.1、 表 示 可 以 支持 Mock 非 接口 类 ， 默 认 只 支持 Mock 接 口 
setImposteriser(ClassImposteriser .INSTANCE); 
}}; 
//2、Mock HibernateTemplate 类 


private final HibernateTemplate mockHibernateTemplate = context.mock(HibernateTemplat 


private IGoodsDao goodsDao = null; 


@Before 

public void setUp() { 
//3、 创 建 ITGoodsDao 实 现 
GoodsHibernateDao goodsDaoTemp = new GoodsHibernateDao( ) ; 
//4、 通 过 ReflectionTestUtils 注 入 需要 的 非 pbublic 字 段 数据 


ReflectionTestUtils.setField(goodsDaoTemp, "entityClass", GoodsModel.class); 


//5、 注 入 mockHibernateTemplate 对 象 
goodsDaoTemp.setHibernateTemplate(mockHibernateTemplate); 
/V/6、 赋 值 给 我 们 要 使 用 的 接口 

goodsDao = goodsDaoTemp ; 


e。 Mockery : jMock 核 心 类 ， 用 于 创建 Mock 对 象 的 ， 通 过 其 mock 方 法 来 创建 相 
的 Mock 对 象 。 





应 接口 或 类 


。 goodsDaoTemp : 需要 测试 的 |GoodsDao 实 现 ， 通 过 ReflectionTestUtils 注 入 需要 的 非 


public 字 段 数据 。 


2、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 IGoodsDao 的 get 方 法 是 否 满足 需求 : 


@Test 

public void testSave () { 
//7、 创 建 需要 的 Mode1 数 据 
final GoodsModel expected = new GoodsModel(); 
//8、 定 义 预期 行为 ， 并 在 后 边 来 验证 预期 行为 是 否 正确 
context.checking(new org.jmock.Expectations() { 


{ 
//9、 表 示 需 要 调用 且 只 调用 一 次 mockHibernateTemplate 的 get 方 法 ， 
// 且 get 方 法 参数 为 (GoodsModel.class，14)， 并 将 返回 goods 
one(mockHibernateTemplate).get(GoodsModel.class, 1); 
will(returnValue(expected)); 


} 

}); 2 

//10、 调 用 goodsDao 的 get 方 法 ， 在 内 部 实现 中 将 委托 给 

//getHibernateTemplate().get(this.entityClass, id); 

// 因 此 按照 第 8 步 定义 的 预期 行为 将 返回 goods 

GoodsModel actual = goodsDao.get(1); 

//11、 来 验证 第 8 步 定义 的 预期 行为 是 否 调 用 了 
context.assertIsSatisfied(); 

//12、 验 证 goodsDao .get(1) 返 回 结果 是 否 正确 

Assert.assertEquals(goods, expected); 


。 context.checking() : 该 方法 中 用 于 定义 预期 行为 ， 其 中 第 9 步 定 义 了 需要 调用 一 次 且 只 
调用 一 次 mockHibernateTemplate 的 get 方 法 ， 且 get 方 法 参数 为 (GoodsModel.class, 1)， 
并 将 返回 goods 对 象 。 

。 goodsDao.get(1) : 调用 goodsDao 的 get 方 法 ， 在 内 部 实现 中 将 委托 
给 “getHibernateTemplate().get(this.entityClass, id)”。 

。 context.assertlsSatisfied() : 来 验证 前 边 定 义 的 预期 行为 是 否 执行 ， 且 是 否 正确 。 

。 Assert.assertEquals(expected, actual) : 用 于 验证 “goodsDao.get(1) "返回 的 结果 是 否 
是 预期 结果 。 


以 上 测试 方法 其 实 是 没有 必要 的 ， 对 于 非常 简单 的 CRUD 没 有 必要 写 单元 测试 ， 只 有 相当 复杂 
的 方法 才 有 必要 写 单元 测试 。 


这 种 通过 Mock 对 象 来 测试 数据 访问 层 代 码 其 实 一 点 意义 没有 ， 因 为 这 里 没有 与 数据 库 交 互 ， 
无 法 验证 各 实 环境 中 与 数据 库 交 互 是 否 正确 ， 因 此 这 里 只 是 告诉 你 如 何 测试 数据 访问 层 代 
码 ， 在 实际 工作 中 一 般 通 过 集成 测试 来 完成 数据 访问 层 测试 。 


13.2.4 业务 逻辑 层 


业务 逻辑 单元 测试 ， 目 的 是 测试 该 层 的 业务 逻辑 是 否 正确 并 通过 Mock 数据 访问 层 对 象 来 隔离 
与 数据 库 交 互 ， 从 而 无 需 连 接 数据 库 即 可 测试 业务 逻辑 是 否 正 确 。 


接 下 来 让 我 们 学 习 一 下 如 何 进 行业 务 逻 辑 层 单元 测试 : 


1、 在 test 文 件 夹 下 创建 如 下 测试 类 : 


package cn.javass,.point.Sservice,impJl; 
// 省 略 import 
public class GoodsCcodeServiceImpJUnitTest { 
//1、Mock 对 象 上 下 文 ， 用 于 创建 Mock 对 象 
private final Mockery context = new Mockery() {{ 
//1.1、 表 示 可 以 支持 Mock 非 接口 类 ， 默 认 只 支持 Mock 接 口 
setIimposteriser(ClassImposteriser .INSTANCE); 
}}; 


//2、Mock IGoodsCcodeDao 接 口 
private IGoodsCodeDao goodsCodeDao = context.mock(IGoodsCodeDao.class);; 


private IGoodsCodeService goodsCodeService,; 


@Before 
public void setUp() { 
GoodsCodeServiceImpl] goodsCodeServiceTemp = new GoodsCodeServiceImpl(); 
//3、 依 赖 注入 
goodsCodeServiceTemp.setDao(goodsCodeDao); 
goodsCodeService = goodsCodeServiceTemp; 


cc 


以 上 测试 支持 代码 和 数据 访问 层 测 试 代码 非常 类 似 ， 在 此 不 再 阐述 。 

2、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 购买 商品 Code 码 是 否 满足 需求 : 

测试 业务 逻辑 时 需要 分 别 测试 多 种 场景 ， 即 如 在 某 种 场景 下 成 功 或 失败 等 等 ， 即 测试 应 该 全 
面 ， 每 个 功能 点 都 应 该 测试 到 。 


2.1、 测 试 购买 失败 的 场景 : 


@Test(expected = NotCodeException.class) 

public void testBuyFail() { 
final int goodsId = 1; 
//4、 定 义 预期 行为 ， 并 在 后 边 来 验证 预期 行为 是 否 正确 
context.checking(new org.jmock.Expectations() { 


{ 
/V/5、 表 示 需 要 调用 goodsCodeDao 对 象 的 getOneNotEXxchanged 一 次 且 仅 以 此 
// 且 返回 值 为 hull 
one(goodsCodeDao).getOneNotExchanged(goodsId); 
will(returnValue(null)); 

} 


goodsCodeService.buy("test", goodsId); 
context.assertIsSatisfied(); 


。 context.checking() : 该 方法 中 用 于 定义 预期 行为 ， 其 中 第 5 步 定 义 了 需要 调用 一 次 且 只 
调用 一 次 goodsCodeDao 的 getOneNotExchanged 方 法 ， 且 getOneNotExchanged 方 法 参 
数 为 (goodsld)， 并 将 返回 null。 

。 goodsCodeService.buy("test", goodsld) : 调用 goodsCodeService 的 buy 方 法 ， 由 于 
调用 goodsCodeDao 的 getOneNotExchanged 方 法 将 返回 null， 因 此 buy 方 法 将 抛 
出 “NotCodeException”" 弄 常 ， 从 而 表示 没有 Code 码 。 

。 context.assertlsSatisfied() : 来 验证 前 边 定义 的 预期 行为 是 否 执 行 ， 且 是 否 正 确 。 

e。 由 于 我 们 在 预期 行为 中 调用 getOneNotExchanged 将 返回 null， 因 此 测试 将 失败 且 抛 出 
NotCodeException 措 常 。 


2.2、 测 试 购 买 成 功 的 场景 : 


@Test() 

public void testBuySuccess () { 
final int goodsId = 1; 
final GoodsCodeModel goodsCode = new GoodsCodeModel(); 
//6、 定 义 预期 行为 ， 并 在 后 边 来 验证 预期 行为 是 否 正确 
context.checking(new org.jmock.Expectations() { 


{ 
/V/7、 表 示 需 要 调用 goodsCodeDao 对 象 的 getOneNotEXxchanged 一 次 且 仅 以 此 
// 且 返回 值 为 hull 
one(goodsCodeDao).getOneNotExchanged(goodsId); 
will(returnValue(goodsCode)); 
//8、 表 示 需 要 调用 goodsCodeDao 对 象 的 Save 方 法 一 次 且 仅 一 次 
// 且 参数 为 goodsCode 
one(goodscodeDao ) ,Save(goodscode ) ; 


}); 
goodsCodeService.buy("test", goodsId); 
context.assertIsSatisfied(); 
Assert.assertEquals(goodsCode.isExchanged(), true); 


。 context.checking() : 该 方法 中 用 于 定义 预期 行为 ， 其 中 第 7 步 定 义 了 需要 调用 一 次 且 只 
调用 一 次 goodsCodeDao 的 getOneNotExchanged 方 法 ， 且 getOneNotExchanged 方 法 参 
数 为 (goodsld)， 并 将 返回 goodsCode 对 象 ; 第 8 步 定 义 了 需要 调用 goodsCodeDao 对 象 的 
Save 一 次 且 仅 一 次 。 

。 goodsCodeService.buy("test", goodsld) : 调用 goodsCodeService 的 buy 方 法 ， 由 于 
调用 goodsCodeDao 的 getOneNotExchanged 方 法 将 返回 goodsCode， 因 此 buy 方 法 将 成 
功 执行 。 

。 context.assertlsSatisfied() : 来 验证 前 边 定义 的 预期 行为 是 否 执行 ， 且 是 否 正 确 。 

。 Assert.assertEquals(goodsCode.isExchanged(), true) : 表示 goodsCode 已 经 被 购买 
过 了 。 

。 由 于 我 们 在 预期 行为 中 调用 getOneNotExchanged 将 返回 一 个 goodsCode 对 象 ， 因 此 测 
试 将 成 功 ， 如 果 失 败 说 明 业 务 逻 辑 写 错 了 。 


到 此 业务 逻辑 层 测试 完毕 ， 在 进行 业务 逻辑 层 测 试 时 我 们 只 关心 业务 逻辑 是 否 正 确 ， 而 不 关 
心底 层 数据 访问 层 如 何 实现 ， 因 此 测试 业务 逻辑 层 时 只 需 Mock 数据 访问 层 对 象 ， 然 后 定义 一 
些 预期 行为 来 满足 业务 逻辑 测试 需求 即 可 。 


13.2.5 表现 层 


表现 层 测试 包括 如 Struts2 的 Action 单 元 测试 、 拦 截 器 单元 测试 、JSP 单 元 测试 等 等 ， 在 此 我 们 
只 学 习 Struts2 的 Action 单 元 测试 。 


Struts2 的 Action 测 试 相对 业务 逻辑 层 测试 相对 复杂 一 些 ， 因 为 牵扯 到 使 用 如 Servlet API、 
ActionContext 等 等 ， 这 里 需要 通过 stub ( 柱 ) 实现 或 mock 对 象 来 模拟 如 HttpServletRequest 
等 对 象 。 


一 、 首 先 学 习 一 些 最 简单 的 Action 测 试 : 


1、 在 test 文 件 夹 下 创建 如 下 测试 类 : 


package cn.javass.point.web.front; 
import cn.javass.point.service.IGoodsCodeService; 
Import cn.javass.point.web.front.action.GoodsAction; 
// 省 略 部 分 import 
public class GoodsActionUnitTest { 
//1、Mock 对 象 上 下 文 ， 用 于 创建 Mock 对 象 
private final Mockery context = new Mockery() {{ 
//1.1、 表 示 可 以 支持 Mock 非 接口 类 ， 默 认 只 支持 Mock 接 口 
setIimposteriser(ClassImposteriser .INSTANCE); 
}}; 


//2、Mock IGoodsCodeService 接 口 
private IGoodsCodeService goodsCodeService = context.mock(IGoodsCodeService.class); 


private GoodsAction goodsAction; 


@Before 

public void setUp() { 
goodsAction = new GoodsAction(); 
//3、 依 赖 注入 
goodsAction.setGoodsCodeService(goodsCodeService); 


| 
以 上 测试 支持 代码 和 业务 逻辑 层 测 试 代码 非常 类 似 ， 在 此 不 再 阐述 。 

2、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 前 台 购 买 商品 Code 码 是 否 满 足 需求 : 

类 似 于 测试 业务 逻辑 时 需要 分 别 测试 多 种 场景 ， 测 试 Action 同 样 需要 分 别 测试 多 种 场景 。 
2.1、 测 试 购 买 失败 的 场景 : 


@Test 

public void testBuyFail() { 
final int goodsId = 1; 
//4、 定 义 预期 行为 ， 并 在 后 边 来 验证 预期 行为 是 否 正确 
context.checking(new org.jmock.Expectations() { 


//5、 表 示 需 要 调用 goodsCodeService 对 象 的 buy 方 法 一 次 且 仅 一 次 

// 且 抛 出 NotCodeException 姑 党 

one(goodsCodeService).buy("test", goodsId); 
will(throwException(new NotCodeException())); 


} 
}); 
//6、 模 拟 Struts 注 入 请 求 参 数 
goodsAction.setGoodsId(goodsId); 
String actualResultCode = goodsAction.buy(); 
context.assertIsSatisfied(); 
Assert.assertEquals(ReflectionTestUtils.getField(goodsAction, "BUY_RESULT"), actualrRe 
Assert.assertTrue(goodsAction.getActionErrors().size() > 0); 





。 context.checking() : 该 方法 中 用 于 定义 预期 行为 ， 其 中 第 5 步 定 义 了 需要 调用 
goodsCodeService 对 象 的 buy 方 法 一 次 且 仅 一 次 且 将 抛 出 NotCodeException 异 常 。 
。 goodsAction.setGoodsld(goodsld) : 用 于 模拟 Struts 注 入 请 求 参数 ， 即 完成 数据 绑 


>= 
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。 goodsAction.buy() : 调用 goodsAction 的 buy 方 法 ， 该 方法 将 委托 给 |GoodsCodeService 
实现 完成 ， 返 回 值 用 于 定位 视图 。 

。 context.assertlsSatisfied() : 来 验证 前 边 定义 的 预期 行为 是 否 执行 ， 且 是 否 正 确 。 

。 Assert.assertEquals(ReflectionTestUtils.getField(goodsAction, "BUY_RESULT"), 
actualResultCode) : 验证 返回 的 Result 是 否 是 我 们 指定 的 。 


。 Assert.assertTrue(goodsAction.getActionErrors().size() > 0) : 表示 执行 Action 时 有 
其 误 ， 即 Action 动 作 错 误 。 如 果 条 件 不 成 立 ， 说 明 我 们 Action 功 能 是 错误 的 ， 需 要 修改 。 


2.2、 测 试 购买 成 功 的 场景 : 


@Test 

public void testBuySuccess() { 
final int goodsId = 1; 
final GoodsCodeModel goodsCode = new GoodsCodeModel(); 
//7、 定 义 预期 行为 ， 并 在 后 边 来 验证 预期 行为 是 否 正确 
context.checking(new org.jmock.Expectations() { 


{ 
//8、 表 示 需 要 调用 goodsCodeService 对 象 的 buy 方 法 一 次 且 仅 一 次 
// 且 返回 goodsCode 对 象 
one(goodsCodeService).buy("test", goodsId); 
will(returnValue(goodsCode)); 

} 


}); 

//9、 模 拟 Struts 注 入 请 求 参 数 

goodsAction.setGoodsId(goodsId); 

String actualResultCode = goodsAction.buy(); 

context.assertIsSatisfied(); 
Assert.assertEquals(ReflectionTestUtils.getField(goodsAction, "BUY_RESULT"), actualrRe 
Assert.assertTrue(goodsAction.getActionErrors().size() == 0); 





。 context.checking() : 该 方法 中 用 于 定义 预期 行为 ， 其 中 第 5 步 定 义 了 需要 调用 
goodsCodeService 对 象 的 buy 方 法 一 次 且 仅 一 次 且 将 返回 goodsCode 对 象 。 

。 goodsAction.setGoodsld(goodsld) : 用 于 模拟 Struts 注 入 请 求 参 数 ， 即 完成 数据 绑 
定 。 

。 goodsAction.buy() : 调用 goodsAction 的 buy 方 法 ， 该 方法 将 委托 给 |GoodsCodeService 
实现 完成 ， 返 回 值 用 于 定位 视图 。 

。 context.assertlsSatisfied() : 来 验证 前 边 定义 的 预期 行为 是 否 执行 ， 且 是 否 正 确 。 

e。 Assert.assertEquals(ReflectionTestUtils.getField(goodsAction, "BUY_RESULT"), 
actualResultCode) : 验证 返回 的 Result 是 否 是 我 们 指定 的 。 


。 Assert.assertTrue(goodsAction.getActionErrors().size() == 0) : 表示 执行 Action 时 没 
有 错误 ， 即 Action 动 作 正 确 。 如 果 条 件 不 成 立 ， 说 明 我 们 Action 功 能 是 错误 的 ， 需 要 修 
改 。 


通过 模拟 ActionContext 对 象 内 容 从 而 可 以 非常 容易 的 测试 Action 中 各 种 与 http 请 求 相 关 情 况 ， 
无 需 依赖 Web 服 务 器 即 可 完成 测试 。 但 对 于 如 果 我 们 使 用 htpp 请 求 相关 对 象 的 该 如 何 测试 ? 如 
果 我 们 需要 使 用 ActionContext 获 取 值 栈 数 据 应 该 怎么 办 ? 这 就 需要 Struts 提 供 的 junit 插 件 支 持 
了 。 我 们 会 在 集成 测试 中 介绍 。 


跟 我 学 Spring 系列 


对 于 表现 层 其 他 功能 的 单元 测试 本 书 不 再 介绍 ， 如 JSP 单 元 测试 、 拦 截 器 单元 测试 等 等 。 


原创 内 容 ， 转 载 请 注 明 私 整 在 线 【http://sishuok.com/forum/blogPost/list/0/2555.htmlj】 





跟 我 学 spring3 381 


【第 十 三 章 】 测试 之 13.3 集成 测试 
spring3 





13.3 集成 测试 


13.3.1 概述 


集成 测试 是 在 单元 测试 之 上 ， 通 常 是 将 一 个 或 多 个 已 进行 过 单元 测试 的 组 件 组 合 起 来 完成 
的 ， 即 集成 测试 中 一 般 不 会 出 现 Mock 对 象 ， 都 是 实 实在 在 的 真 实 实现 。 


对 于 单元 测试 ， 如 前 边 在 进行 数据 访问 层 单元 测试 时 ， 通 过 Mock HibernateTemplate 对 象 然 
后 将 其 注入 到 相应 的 DAO 实 现 ， 此 时 单元 测试 只 测试 菜 层 的 某 个 功能 是 否 正确 ， 对 其 他 层 如 
何 提供 服务 采用 Mock 方 式 提供 。 


对 于 集成 测试 ， 如 要 进行 数据 访问 层 集成 测试 时 ， 需 要 实 WA 
后 将 其 注入 到 相应 的 DAO 实 现 ， 此 时 集成 测试 将 不 仅 测 试 该 层 功能 是 否 正确 ， 还 将 测试 服务 
提供 者 提供 的 服务 是 否 正 确 执 行 。 


使 用 Spring 的 一 个 好 处 是 能 非常 简单 的 进 ae 无 需 依赖 web 服 务 器 或 应 用 服务 器 即 可 
完成 测试 。Spring 通 过 提供 一 套 TestContext 框 架 来 简化 集成 测试 ， 使 用 TestContext 测 试 框架 
能 获得 许多 好 处 ， 如 Spring loC 容 器 缓存 、 事 务 管 理 、 依 赖 注入 、Spring 测 试 支持 类 等 等 。 


13.3.2 Spring TestContext 框 架 支持 
Spring TestContext 框 架 提 供 了 一 些 通用 的 集成 测试 支持 ， 主 要 提供 如 下 支持 : 
一 、 上 下 文 管理 及 缓存 : 


ae Ra 应 该 只 有 一 个 上 下 文 ， 而 不 是 每 个 测试 方法 都 创建 新 的 上 下 
这 样 有 助 于 减少 启动 容器 的 开销 ， 提 供 测试 效率 。 可 通过 如 下 方式 指定 要 加 载 的 上 下 
。 
@RuNWith(SpringJUnit4ClassRunner.class) 
@ContextCconfiguration( 
locations={"classpath:applicationContext-resources-test.xml", 


"classpath:cn/javass/point/dao/applicationContext-hibernate.xml"}) 
public class GoodsHibernateDaoIntegrationTest { 


} 
二 了 | 
。 locations : 指定 Spring 配置 文件 位 置 ; 


。 inheritLocations : 如 果 设 置 为 false， 将 屏蔽 掉 父 类 中 使 用 该 注解 指定 的 配置 文件 位 
默认 为 true 表 示 继 承 父 类 中 使 用 该 注解 指定 的 配置 文件 位 置 。 


二 、Test Fixture (测试 国 件 ) 的 依赖 注入 : 


Test Fixture 可 以 指 运行 测试 时 需要 的 任何 东西 ， 一 般 通 过 
准备 这 些 资 源 ， 而 通过 @After 定 义 的 销毁 Fixture 方 法 销毁 或 还 些 资源 。 


Test Fixture 的 依赖 注入 就 是 使 用 Spring loC 容 器 的 注入 功能 准备 和 销毁 这 些 资 源 。 可 通过 如 下 
方式 注入 Test Fixture : 


@Autowired 

private IGoodsDao goodsDao; 
@Autowired 

private ApplicationContext ctx; 


即 可 以 通过 Spring 提供 的 注解 实现 Bean 的 依赖 注入 来 完成 Test Fixture 的 依赖 注入 。 
三 、 事 务 管 理 : 


人 理 支 持 ， 即 使 用 Spring 容器 的 事务 管理 功能 ， 从 而 可 以 独立 于 应 用 服务 
完成 事务 相关 功能 的 测试 。 为 了 使 测试 中 的 事务 管理 起 作用 需要 通过 如 下 方式 开启 测试 类 


@RuNWith(SpringJUnit4ClassRunner.class) 
@ContextCconfiguration( 
locations={"classpath:applicationContext-resources-test.xmil", 
"classpath:cn/javass/point/dao/applicationContext-hibernate.xml"}) 
@TransactionCconfiguration( 


transactionManager = "txManager", defaultRollback=true) 
public class GoodsHibernateDaoIntegrationTest { 
} 


Spring 提供 如 下 事务 相关 注解 来 支持 事务 管理 : 
。 @Transactional : 使 用 @Transactional 注 解 的 类 或 方法 将 得 到 事务 支持 
。 transactionManager: 指 定 事务 管理 器 ; 
。 defaultRollback : 是 否 回 滚 事务 ， 软 认为 true 表 示 回 滚 事务 

Spring 还 通过 提供 如 下 注解 来 简化 事务 测试 : 


。 @Transactional : 使 用 @Transactional 注 解 的 类 或 方法 表示 需要 事务 支持 ; 

。 @NotTransactional : 只 能 注解 方法 ， 使 用 @NotTransactional 注 解 的 方法 表示 不 需要 事 
务 支 持 ， 即 不 运行 在 事务 中 ，Spring 3 开始 已 不 推荐 使 用 ; 

。 @BeforeTransaction 和 人 @AfterTransaction : 使 用 这 两 个 注解 注解 的 方法 定义 了 在 一 个 
事务 性 测试 方法 之 前 或 之 后 执行 的 行为 ， 且 被 注解 的 方法 将 运行 在 该 事务 性 方法 的 事务 
之 外 。 

。 @Rollback(true) : 默认 为 true， 用 于 替换 @TransactionConfiguration 中 定义 的 
defaultRollback 指 定 的 回 滚 行为 。 


四 、 常 用 注解 支持 : Spring 框架 提供 如 下 注解 来 简化 集成 测试 : 


。 @DirtiesContext : 表示 每 个 测试 方法 执行 完毕 需 关闭 当前 上 下 文 并 重建 一 个 全 新 的 上 下 
文 ， 即 不 缓存 上 下 文 。 可 应 用 到 类 或 方法 级 别 ， 但 在 JUnit 3.8 中 只 能 应 用 到 方法 级 别 。 

。 @ExpectedException : 表示 被 注解 的 方法 预期 将 抛 出 一 个 异常 ， 使 用 如 
@ExpectedException(NotCodeException.class) 来 指定 异常 ， 定 义 方 式 类 似 于 Junit 4 中 
的 @Test(expected = NotCodeException.class)，@ExpectedException 注 解 和 
@Test(expected =......) 应 该 两 者 选 一 。 

。 @Repeat : 表示 被 注解 的 方法 应 被 重复 执行 多 少 次 ， 使 用 如 @Repeat(2) 方 式 指定 。 

。 @Timed : 表示 被 注解 的 方法 必须 在 多 长 时 间 内 运行 完毕 ， 超 时 将 抛 出 异常 ， 使 用 如 
@Timed(millis=10) 方 式 指定 ， 单 位 为 毫秒 。 注 意 此 处 指定 的 时 间 是 如 下 方法 执行 时 间 之 
和 : 测试 方法 执行 时 间 (或 者 任何 测试 方法 重复 执行 时 间 之 和 ) 、@Before 和 @After 注 
解 的 测试 方法 之 前 和 之 后 执行 的 方法 执行 时 间 。 而 Junit 4 中 的 @Test(timeout=2) 指 定 的 起 
时 时 间 只 是 测试 方法 执行 时 间 ， 不 包括 任何 重复 等 。 

。 除了 支持 如 上 注解 外 ， 还 支持 【第 十 二 章 零 配置 】 中 依赖 注入 等 注解 。 


五 、TestContext 框 架 支持 类 : 提供 对 测试 框架 的 支持 ， 如 Junit、TestNG 测 试 框架 ， 用 于 集 
成 Spring TestContext 和 测试 框架 来 简化 测试 ，TestContext 框 架 提供 如 下 支持 类 : 


。 JUnit 3.8 支 持 类 : 提供 对 Spring TestContext 框 架 与 Junit3.8 测 试 框架 的 集成 : 


AbstractJUnit38SpringContextTests : 我 们 的 测试 类 继承 该 类 后 将 获取 到 Test Fixture 的 依 
赖 注 入 好 处 。 


AbstractTransactionalJUnit38SpringContextTests : 我 们 的 测试 类 继承 该 类 后 除了 能 得 到 
Test Fixture 的 依赖 注入 好 处 ， 还 额外 获取 到 事务 管理 支持 。 


e。 JUnit 4.5+ 支 持 类 : 提供 对 Spring TestContext 框 架 与 Junit4.5+ 测 试 框架 的 集成 : 


AbstractJUnit4SpringContextTests : 我 们 的 测试 类 继承 该 类 后 将 获取 到 Test Fixture 的 依赖 
注入 好 处 。 


AbstractTransactionalJUnit4SpringContextTests : 我 们 的 测试 类 继承 该 类 后 除了 能 得 到 
Test Fixture 的 依赖 注入 好 处 ， 还 额外 获取 到 事务 管理 支持 。 


e。 定制 Junit4.5+ 运 行 器 : 通过 定制 自己 的 Junit4.5+ 运 行 器 从 而 无 需 继承 JUnit 4.5+ 支 持 类 
即 可 完成 需要 的 功能 ， 如 Test Fixture 的 依赖 注入 、 事 务 管理 支持 ， 


@RunWith(SpringJUnit4ClassRunner.class) : 使 用 该 注解 注解 到 测试 类 上 表示 将 集成 
Spring TestContext 和 Junit 4.5+ 测 试 框架 。 


@TestExecutionListeners : 该 注解 用 于 指定 TestContext 框 架 的 监听 器 用 于 与 TestContext 杠 
架 管理 器 发 布 的 测试 执行 事件 进行 交互 ，TestContext 框 架 提 供 如 下 三 个 默认 的 监听 器 : 
DependencylnjectionTestExecutionListener、DirtiesContextTestExecutionListener、 
TransactionalTestExecutionListener 分 别 完成 对 Test Fixture 的 依赖 注入 、@DirtiesContext 支 
持 和 事务 管理 支持 ， 即 在 默认 情况 下 将 自动 注册 这 三 个 监听 器 ， 另 外 还 可 以 使 用 如 下 方式 指 


> | 大 PR  。 
定 监 听 疾 : 


@RuNWith(SpringJUnit4ClassRunner.class) 
@TestExecutionListeners({}) 
public class GoodsHibernateDaoIntegrationTest { 


} 
如 上 配置 将 通过 定制 的 Junit4.5+ 运 行 器 运行 ， 但 不 会 完成 Test Fixture 的 依赖 注入 、 事 务 管 理 
等 等 ， 如 果 只 需要 Test Fixture 的 依赖 注入 ， 可 以 使 用 


@TestExecutionListeners({DependencylnjectionTestExecutionListener.class}) 指 定 。 
。 TestNG 支 持 类 : 提供 对 Spring TestContext 框 架 与 TestNG 测 试 框架 的 集成 : 


AbstractTestNGSpringContextTests : 我 们 的 测试 类 继承 该 类 后 将 获取 到 Test Fixture 的 依 
赖 注 入 好 处 。 


AbstractTransactionalTestNGSpringContextTests : 我 们 的 测试 类 继承 该 类 后 除了 能 得 到 
Test Fixture 的 依赖 注入 好 处 ， 还 额外 获取 到 事务 管理 支持 。 


到 此 Spring TestContext 测 试 框 架 减 少 完 毕 了 ， 接 下 来 让 我 们 学 习 一 下 如 何 进行 集成 测试 吧 。 


13.3.3 准备 集成 测试 环境 


对 于 集成 测试 环境 各 种 配置 应 该 和 开发 环境 或 实际 生产 环境 配置 相 分 离 ， 即 集成 测试 时 应 该 
使 用 单独 搭建 一 套 独立 的 测试 环境 ， 不 应 使 用 开发 环境 或 实际 生产 环境 的 配置 ， 从 而 保证 测 
试 环境 、 开 发 、 生 产 环 境 相 分 离 。 


1、 找 贝 一 份 Spring 资源 配置 文件 applicationContext-resources.xml， 并 命名 为 
applicationContext-resources-test.xml 表 示 用 于 集成 测试 使 用 ， 并 修改 如 下 内 容 : 


<bean class="org.Sspringframework.beans ,factory,.config,PropertyPlaceholderCconfigurer"> 
<property name="locations"> 
<list> 
<value>classpath:resources-test.properties</value> 
</list> 
</property> 
</bean> 


2、 找 贝 一 份 蔡 换 配 置 元 数据 的 资源 文件 (resources/resources.properties) ， 并 命名 为 
resources-test.properties 表 示 用 于 集成 测试 使 用 ， 并 修改 为 以 下 内 容 : 


db.driver.class=org.hsqldb.jdbcDriver 
db.url=jdbc:hsqldb:mem:point_shop 

db .username=sa 

db .password= 

#Hibernate 属 性 
hibernate.dialect=org.hibernate.dialect.HSQLDialect 
hibernate.hbm2ddl,auto=create-drop 

hibernate. show_sql=false 

hibernate.format_sql=true 


。 jdbc:hsqldb:mem:point_shop : 我 们 在 集成 测试 时 将 使 用 HSQLDB， 并 采用 内 存 数 据 


库 模 式 运行 ; 
。 hibernate.hbm2ddl.auto=create-drop : 表示 在 创建 SessionFactory 时 根据 Hibernate 映 
射 配置 创建 相应 Model 的 表 结构 ， 并 在 SessionFactory 关 闭 时 删除 这 些 表 结构 。 


到 此 我 们 测试 环境 修改 完毕 ， 在 进行 集成 测试 时 一 定 要 保证 测试 环境 、 开 发 环境 、 实 际 生 产 
环境 相 分 离 ， 即 对 于 不 同 的 环境 使 用 不 同 的 配置 文件 。 


13.3.4 数据 访问 层 


数据 访问 层 集成 测试 ， 同 单元 测试 一 样 目 的 不 仅 测 试 该 层 定义 的 接口 实现 方法 的 行为 是 否 正 
确 ， 而 且 还 要 测试 是 否 正确 与 数据 库 交 互 ， 是 否 发 送 并 执行 了 正确 的 SQL，SQL 执 行 成 功 后 
是 否 正 确 的 组 装 了 业务 逻辑 层 需 要 的 数据 。 


数据 访问 层 集成 测试 不 再 通过 Mock 对 象 与 数据 库 交 互 的 API 来 完成 测试 ， 而 是 使 用 实 实在 在 
存在 的 与 数据 库 交 互 的 对 象 来 完成 测试 。 


接 下 来 让 我 们 学 习 一 下 如 何 进行 数据 访问 层 集 成 测试 


1、 在 test 文 件 夹 下 创建 如 下 测试 类 : 


package cn.javass.point.dao,.hibernate 
// 省 略 import 
@RuNWith(SpringJUnit4ClassRunner.class) 
@ContextCconfiguration( 
locations={"classpath:applicationContext-resources-test.xml", 
"classpath:cn/javass/point/dao/applicationContext-hibernate.xml"}) 
@TransactionConfiguration(transactionManager = "txManager", defaultRollback=false) 
public class GoodsHibernateDaoIntegrationTest { 
@Autowired 
private ApplicationContext ctx; 
@Autowired 
private IGoodsCodeDao goodsCodeDao; 


二 | 


. @runWiihl spnngd UnidolessRunner class) : 表示 使 用 自己 定制 的 Junit4.5+ 运 行 器 来 
运行 测试 ， 即 完成 Spring TestContext 框 架 与 Junit 集 成 ; 
。 @ContextConfiguration : 指定 要 加 载 的 Spring 配置 文件 ， 此 处 注意 我 们 的 Spring 资源 
配置 文件 为 applicationContext-resources-test.xmP”; 
。 @TransactionConfiguration : 开启 测试 类 的 事务 管理 支持 配置 ， 并 指定 事务 管理 器 和 
默认 回 滚 行为 ; 
。 @Autowired : 完成 Test Fixture (测试 固件 ) 的 依赖 注入 。 


2、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 分 页 查询 所 有 已 发 布 的 商品 是 否 满足 需求 : 


@Transactional 

@Rollback 

@Test 

public void testListAllPublishedSuccess() { 
GoodsModel] goods = new GoodsModel(); 
goods.setDeleted(false); 
goods.setDescription(""); 
goods .setName ("测试 商品 ")， 
goods.setPublished(true); 
goodsDao.save(goods); 
Assert.assertTrue(goodsDao.1istAllPublished(1).size() == 1); 
Assert.assertTrue(goodsDao.1istAllPublished(2).size() == 0); 


。 @Transactional : 表示 测试 方法 将 允许 在 事务 环境 ; 
。 @Rollback : 表示 替换 @ContextConfiguration 指 定 的 默认 事务 回 滚 行为 ， 即 将 在 测试 方 
法 执行 完毕 时 回 滚 事务 。 


数据 访问 层 的 集成 测试 也 是 非常 简单 ， 与 数据 访问 层 的 单元 测试 类 似 ， 也 应 该 只 对 复杂 的 数 
据 访问 层 代 码 进 行 测试 。 


13.3.5 业务 逻辑 层 


业务 逻辑 层 集 成 测试 ， 目 的 同样 是 测试 该 层 的 业务 逻辑 是 否 正 确 ， 对 于 数据 访问 层 实现 通过 
Spring loC 容 器 完成 装配 ， 即 使 用 丨 实 的 数据 访问 层 实现 来 获取 相应 的 底层 数据 。 


接 下 来 让 我 们 学 习 一 下 如 何 进行 业务 逻辑 层 集成 测试 


1、 在 test 文 件 夹 下 创建 如 下 测试 类 : 


@ContextCconfiguration( 

locations={"classpath:applicationContext-resources-test,.xml", 
"classpath:cn/javass/point/dao/applicationContext-hibernate.xml", 
"classpath:cn/javass/point/service/applicationContext-service.xml"}) 


@TransactionCconfiguration(transactionManager = "txManager", defaultRollback=false) 

public class GoodsCodeServiceIimplIintegrationTest extends AbstractJUnit4SpringContextTests 
Q@Autowired 
private IGoodsCodeService goodsCodeService,; 
Q@Autowired 


private IGoodsService goodsService; 





。 AbstractJUnit4SpringContextTests : 表示 将 Spring TestContext 框 架 与 Junit4.5+ 测 试 
框架 集成 ; 

。 @ContextConfiguration : 指定 要 加 载 的 Spring 配置 文件 ， 此 处 注意 我 们 的 Spring 资源 
配置 文件 为 “applicationContext-resources- -test.xmj”" 

。 @TransactionConfiguration : 开启 测试 类 的 事务 管 和 ， 并 指定 事务 管理 器 和 
默认 回 滚 行为 ; 

。 @Autowired : 完成 Test Fixture (测试 固件 ) 的 依赖 注入 。 


2、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 购买 商品 Code 码 是 否 满足 需求 : 


2.1、 测 试 购买 失败 的 场景 : 


@Transactional 

@Rollback 

@ExpectedException(NotCodeException.c]lass) 

@Test 

public void testBuyFail() { 
goodsCodeService.buy("test", 1); 

} 


由 于 我 们 数据 库 中 没有 相应 商品 的 Code 码 ， 因 此 将 抛 出 NotCodeException 异 常 。 


2.2、 测 试 购 买 成 功 的 场景 : 


@Transactional 
@Rollback 
@Test 
public void testBuySuccess() { 
//1. 添 加 商品 
GoodsModel goods = new GoodsModel(); 
goods.setDeleted(false); 
goods.setDescription(""); 
goods ,setName ("测试 商品 ")， 
goods.setPublished(true); 
goodsService,.save(goods); 
//2. 添 加 商品 Code 码 
GoodsCodeModel goodscode = new GoodsCodeModel(); 
goodsCode.setGoods(goods); 
goodsCode.setCode("test"); 
goodsCodeService.save(goodsCode); 
//3. 测 试 购买 商品 Code 码 
GoodsCodeModel resultGoodsCode = goodsCodeService.buy("test", 1); 
Assert.assertEquals(goodsCode.getId(), resultGoodsCode.getId()); 


由 于 我 们 添加 了 指定 商品 的 Code 码 因此 购买 将 成 功 和 
业务 逻辑 层 的 集成 测试 也 是 非常 简单 ， 与 业务 逻辑 层 的 单元 测试 类 似 ， 也 应 该 只 对 复杂 的 业 
务 逻 辑 层 代码 进行 测试 。 

13.3.5 表现 层 


对 于 表现 层 集成 测试 ， 同 样 类 似 于 单元 测试 ， 但 对 于 业务 逻辑 层 都 将 使 用 真实 的 实现 ， 而 不 
再 是 通过 Mock 对 象 来 测试 ， 这 也 是 集成 测试 和 单元 测试 的 区 别 。 


接 下 来 让 我 们 学 习 一 下 如 何 进行 表现 层 Action 集 成 测试 : 


1、 准 备 Struts 提 供 的 junit 插 件 , 到 struts-2.2.1.1.zip 中 拷贝 如 下 jar 包 到 类 路 径 : 


lib\struts2-junit-plugin-2.2.1.1.jar 


2、 测 试 支持 类 : Struts2 提 供 StrutsSpringTestCase 测 试 支持 类 ， 我 们 所 有 的 Action 测 试 类 都 
需要 继承 该 类 ; 


、 准备 Spring 配 置 文件 : 由 于 我 们 的 测试 类 继承 StrutsSpringTestCase 且 将 通过 和 窗 盖 该 类 的 
esiss es 定 Spring 配 置 文件 ， 但 由 于 getContextLocations 方 法 只 能 返回 
一 个 配置 文件 ， 因 此 我 们 需要 新 建 一 个 用 于 导入 其 他 Spring 配置 文件 的 配置 文件 
applicationContext-test.xml， 具 体内 容 如 下 : 


<import resource="classpath:applicationContext-resources-test.xml"/> 

<import resource="classpath:cn/javass/point/dao/applicationContext-hibernate.xml"/> 
<import resource="classpath:cn/javass/point/service/applicationContext-service.xml"/> 
<import resource="classpath:cn/javass/point/web/pointShop-admin-servlet.xml"/> 
<import resource="classpath:cn/javass/point/web/pointShop-front-servlet.xml"/> 


3、 在 test 文 件 夹 下 创建 如 下 测试 类 


package cn.javass.point.web.front; 
// 省 略 import 
@RuNWith(SpringJUnit4ClassRunner.class) 
@TestExecutionListeners({}) 
public class GoodsActionIntegrationTest extends StrutsSpringTestCase { 
Q@Override 
protected String getContextLocations() { 
return "classpath:applicationContext-test.xml"; 
} 


@Before 

public void setUp() throws Exception { 
//1 指定 Struts2 配 置 文件 
// 该 方式 等 价 于 通过 web .xml 中 的 <init-param> 方 式 指定 参数 
Map<String, String> dispatcherInitParams = new HashMap<String, String>(); 
ReflectionTestUtils.setField(this, "dispatcherInitParams", dispatcherInitParams); 
//1.1 指定 Struts 配 置 文件 位 置 
dispatcherInitParams.put("config", "struts-default.xml,struts-plugin.xml,struts.x 
super .setUp(); 

} 

@After 

public void tearDown() throws Exception { 
super .tearDown(); 





。 @RunWith(SpringJUnit4ClassRunner.class) : 表示 使 用 自己 定制 的 Junit4.5+ 运 行 器 来 
运行 测试 ， 即 完成 Spring TestContext 框 架 与 Junit 集 成 ; 

。 @TestExecutionListeners( 人 {}) : 没有 指定 任何 监听 器 ， 即 不 会 自动 完成 对 Test Fixture 的 
依赖 注入 、@DirtiesContext 支 持 和 事务 管理 支持 ; 

。 StrutsSpringTestCase : 集成 测试 Struts2+Spring 时 所 有 集成 测试 类 必须 继承 该 类 ; 

。 setUp 方 法 : 在 每 个 测试 方法 之 前 都 执行 的 初始 化 方法 ， 其 中 dispatcherlnitParams 用 于 
指定 等 价 于 在 web.xml 中 的 <init-param> 方 式 指定 的 参数 ; 必须 调用 SupersetUp() 用 于 初 
始 化 Struts2 和 Spring 环境 。 

。 tearDown() : 在 每 个 测试 方法 之 前 都 执行 的 销毁 方法 ， 必 须 调用 super'tearDown() 来 销毁 
Spring 容器 等 。 


4、 测 试 支持 写 完 后 ， 接 下 来 测试 一 下 前 台 购 买 商品 Code 码 是 否 满足 需求 : 


4.1、 测 试 购 买 失 败 的 场景 : 


@Test 
public void testBuyFail() throws UnsupportedEncodingException, ServletException { 


//2 前 全 购买 商品 失败 

//2.1 首先 重 置 hhtp 相 关 对 象 ， 并 准备 准备 请 求 参 数 

initServletMockObjects(); 

request.setPparameter("goodsId", String.valueof(Integer.MIN_VALUE)); 

//2.2 调用 前 台 GoodsAction 的 buy 方 法 完成 购买 相应 商品 的 Code 码 
executeAction("/goods/buy.action"); 

GoodsAction frontGoodsAction = (GoodsAction) ActionContext.getContext().getActionInvo 
//2.3 验证 前 台 GoodsAction 的 buy 方 法 有 错误 
Assert.assertTrue(frontGoodsAction.getActionErrors().size() > 0); 
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initServletMockObjects() : 用 于 重 置 所 有 http 相 关 对 象 ， 如 request 等 ; 
request.setParameter("goodsld", String.valueOf(Integer.MIN_VALUE)) : 用 于 准备 
请 求 参数 ; 

executeAction("/goods/buy.action") : 通过 模拟 http 请 求 来 调用 前 台 GoodsAction 的 buy 
方法 完成 商品 购买 

Assert.assertTrue(frontGoodsAction.getActionErrors().size() > 0) : 表示 执行 Action 
时 有 错误 ， 即 Action 动 作 错 误 。 如 果 条 件 不 成 立 ， 说 明 我 们 Action 功 能 是 错误 的 ， 需 要 修 
改 。 


4.2、 测 试 购 买 成 功 的 场景 : 


@Test 


public void testBuySuccess() throws UnsupportedEncodingException, ServletException { 


//3 后 台新 增 商品 

//3.1 准备 请 求 参 数 

request ,setParameter("goods ,name"，" 测 试 商品 " ) ; 
request.setParameter("goods .description"，" 测 试 商品 描述 " ) ; 
request.setParameter("goods.originalPoint", "1"); 
request.setPparameter("goods.nowPoint", "2"); 
request.setPparameter("goods.published", "true"); 

//3.2 调用 后 台 GoodsAction 的 add 方 法 完成 新 增 
executeAction("/admin/goods/add.action"); 

//2.3 获取 GoodsAction 的 goods 属 性 

GoodsModel] goods = (GoodsModel) findValueAfterExecute("goods"); 
//4 后 台新 增 商 品 Code 码 

//4.1 首先 重 置 hhtp 相 关 对 象 ， 并 准备 准备 请 求 参 数 
initServletMockObjects(); 

request.setParameter("goodsId", String.valueof(goods.getId())); 
request.setPparameter("codes", "a\rb"); 

//4.2 调用 后 人 台 GoodsCodeAction 的 add 方 法 完成 新 增 商品 Code 码 
executeAction("/admin/goodsCode/add.action"); 

//5 前 合 购买 商品 成 功 

//5.1 首先 重 置 hhtp 相 关 对 象 ， 并 准备 准备 请 求 参 数 
initServletMockObjects(); 

request.setParameter("goodsId", String.valueof(goods.getId())); 
//5.2 调用 前 台 GoodsAction 的 buy 方 法 完成 购买 相应 商品 的 Code 码 
executeAction("/goods/buy.action"); 

GoodsAction frontGoodsAction = (GoodsAction) ActionContext.getContext().getActionInvo 
//5.3 验证 前 台 GoodsAction 的 buy 方 法 没有 错误 
Assert.assertTrue(frontGoodsAction.getActionErrors().size() == 0); 
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。 executeAction("/admin/goods/add.action") : 调用 后 台 GoodsAction 的 add 方 法 ， 用 于 


新 增 商 品 ; 


。 executeAction("/admin/goodsCode/add.action") : 调用 后 台 GoodCodeAction 的 add 
方法 用 于 新 增 商品 Code 码 ; 

。 executeAction("/goods/buy.action") : 调用 前 台 GoodsAction 的 buy 方 法 ， 用 于 购买 相 
应 商品 ， 其 中 Assert.assertTrue(frontGoodsAction.getActionErrors().size() == 0) 表 示 购 
买 成 功 ， 即 Action 动 作 正 确 。 


表现 层 Action 集 成 测试 介绍 就 到 此 为 止 ， 如 何 深入 StrutsSpringTestCase 来 完成 集成 测试 已 超 
出 本 书 范围 ， 如 果 读 者 对 这 部 分 感 兴 趣 可 以 到 Struts2 官 网 学 习 最 新 的 测试 技巧 。 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/0/2557.html]】 


跟 我 学 Spring MVC 


作者 : 开 涛 


来 源 : 跟 开 涛 学 SpringMVC 


SpringMVC + spring3.1.1 + hibernate4.1.0 集成 
及 钊 见 问 题 总 结 


下 载 地 址 


一 开发 环境 


1、 动 态 web 工 程 


2、 部 分 依赖 


hibernate-release-4.1.0.Final.zip 
hibernate-validator-4.2.0.Final.jar 
spring-framework-3.1.1.RELEASE-with-docs.zip 
proxoo01-0.9.1.jar 

1og4j 1.2.16 

slf4j -1.6.1 

mysql-connector-java-5.1.10.jar 

hamcrest 1.3.0RC2 

ehcache 2.4.3 


3、 为 了 方便 学 习 ， 暂 没有 使 用 maven 构 建 工程 


二 工程 主要 包括 内 容 
1、springMVC + spring3.1.1 + hibernate4.1.0 集 成 
2、 通 用 DAO 层 和 Service 层 

3、 二 级 缓存 Ehcache 

4、REST 风 格 的 表现 层 

5、 通 用 分 页 (两 个 版 本 ) 

5.1、 首 页 上 一 页 ,下 一 页 尾 页 跳 转 

5 .2、 上 一 页 12345 下 一 页 

6、 数 据 库 连接 池 采 用 proxool 

7、spring 集 成 测试 

8、 表 现 层 的 java validator 框 架 验证 (采用 hibernate-validator-4.2.0 实 现 ) 


9、 视 图 采用 JSP， 并 进行 组 件 化 分 离 


三 TODO LIST 将 本 项 目 做 成 脚手架 方便 以 后 新 项 目 查 
询 

1、Service 层 进行 AOP 缓 存 〈 缓 存 使 用 Memcached 实 现 ) 

2、 单 元 测试 (把 常见 的 柱 测 试 、 伪 实现 、 模 拟 对 象 演示 一 别 集成 测试 ) 
3、 监 控 功 能 

后 台 查 询 hibernate 二 级 缓存 hit/miss 举 功能 

后 台 查询 当前 服务 器 状态 功能 〈 如 线程 信息 、 服 务 器 相关 信息 ) 

4、spring RPC 功 能 

5、spring 集 成 quartz 进行 任务 调度 

6、spring 集 成 java mail 进行 邮件 发 送 

7、DAO 层 将 各 种 常用 框架 集成 进来 (方便 查询 ) 


8、 把 工作 中 经 常用 的 东西 融合 进去 ， 作 为 脚手架 ， 方 便 以 后 查询 


四 集成 重点 及 常见 问题 
1、spring-config.xml 配置 文件 : 


1.1、 该 配置 文件 只 加 载 除 表现 层 之 外 的 所 有 bean， 因 此 需要 如 下 配置 


<context:component-scan base-package="cn.javass"> 
<context:exclude-filter type="annotation" expression="org.springframework.stereot 
</context:component-scan> 


| 


通过 exclude-filter 把 所 有 @Controller 注 解 的 表现 层 控制 器 组 件 排除 





1.2、 国 际 化 消息 文件 配置 


<!-- 国际 化 的 消息 资源 文件 --> 
<bean id="messageSource" class="org.springframework.context.support.ReloadableResourc 
<property name="basenames"> 
<list> 
<1-- 在 web 环 境 中 一 定 要 定位 到 classpath 否则 默认 到 当前 web 应 用 下 找 ”--> 
<value>classpath:messages</value> 
</list> 
</property> 
<property name="defaultEncoding" value="UTF-8"/> 
<property name="cacheSeconds" value="60"/> 
</bean> 








此 处 basenames 内 一 定 是 classpath:messages ， 如 果 你 写 出 "messages”， 将 会 到 你 的 web 应 
用 的 根 下 找 即 你 的 messages.properties 一 定 在 web 应 用 /messages.propertis。 


1.3、hibernate 的 sessionFactory 配 置 需要 使 用 
org.springframework.orm.hibernate4.LocalSessionFactoryBean， 其 他 都 是 类 似 的 ， 具 体 看 
源 代码 。 


1 . 4、<aop:aspectj-autoproxy expose-proxy="true"/> 实现 @AspectJ 注 解 的 ， 默 认 使 用 
AnnotationAwareAspectJAutoProxyCreator 进 行 AOP 代 理 ， 它 是 BeanPostProcessor 的 子 

& ， 在 容器 启动 时 Bean 初 始 化 开始 和 结束 时 调用 进行 AOP 代 理 的 创建 ， 因 此 只 对 当 容 器 启动 
时 有 效 ， 使 用 时 注意 此 处 。 


1.5、 声 明 式 容器 管理 事务 


建议 使 用 声明 式 容器 管理 事务 ， 而 不 建议 使 用 注解 容器 管理 事务 (虽然 简单 ) ， 但 大 分 布 式 
了 ， 采 用 声明 式 容器 管理 事务 一 般 只 对 service 层 进行 处 理 。 


<tx:advice id="txAdvice" transaction-manager="txManager"> 
<tx:attributes> 
<tx:method name="save*" propagation="REQUIRED" /> 
<tx:method name="add*" propagation="REQUIRED" /> 
<tx:method name="create*" propagation="REQUIRED" /> 
<tx:method name="insert*" propagation="REQUIRED" /> 
<tx:method name="update*" propagation="REQUIRED" /> 
<tx:method name="merge*" propagation="REQUIRED" /> 
<tx:method name="del*" propagation="REQUIRED" /> 
<tx:method name="remove*" propagation="REQUIRED" /> 
<tx:method name="put*" propagation="REQUIRED" /> 
<tx:method name="use*" propagation="REQUIRED"/> 
<!1--hibernate4 必 须 配 置 为 开启 事务 否则 getCurrentSession() 获 取 不 到 - -> 
<tx:method name="get*" propagation="REQUIRED" read-only="true" /> 
<tx:method name="count*" propagation="REQUIRED" read-only="true" /> 
<tx:method name="find*" propagation="REQUIRED" read-only="true" /> 
<tx:method name="list*" propagation="REQUIRED" read-only="true" /> 
<tx:method name="*" read-only="true" /> 
</tx:attributes> 
</tx:advice> 
<aop:config expose-proxy="true"> 
<1-- 只 对 业务 逻辑 层 实施 事务 --> 
<aop:pointcut id="txPointcut" expression="execution(* cn.javass..service..*.*(..) 
<aop:advisor advice-ref="txAdvice" pointcut-ref="txPointcut"/> 
</aop:config> 


到 王 了 上 灾 于 


此 处 一 定 注意 使 用 hibernate4， 在 不 使 用 OpenSessionInView 模 式 时 ， 在 使 用 
getCurrentSession() 时 会 有 如 下 问题 : 





当 有 一 个 方法 list 传播 行为 为 Supports， 当 在 另 一 个 方法 getPage()〈 无 事务 ) 调用 list 方 法 时 
会 抛 出 org.hibernate.HibernateException: No Session found for current thread 措 常 。 


这 是 因为 getCurrentSession() 在 没有 session 的 情况 下 不 会 自动 创建 一 个 ， 不 知道 这 是 不 是 
Spring3.1 实 现 的 pbug， 欢 迎 大 家 讨论 下 。 


此 最 好 的 解决 方案 是 使 用 REQUIRED 的 传播 行为 。 


二 、Spring-servlet.xml : 


2.1、 表 现 层 配置 文件 ， 只 应 加 装 表 现 层 Bean， 否 则 可 能 引起 问题 。 


<!-- 开启 controller 注 解 支持 --> 

<!-- 注 : 如果 base-package=cn.javass 则 注解 事务 不 起 作用 - -> 

<context:component-scan base-package="cn.javass.demo.web.controller"> 
<context:include-filter type="annotation" expression="org.springframework.stereot 

</context:component-scan> 


到 El:: 


此 处 只 应 该 加 载 表 现 层 组 件 ， 如 果 此 处 还 加 载 dao 层 或 service 层 的 bean 会 将 之 前 容器 加 载 的 
替换 掉 ， 而 且 此 处 不 会 进行 AOP 织 入 ， 所 以 会 造成 AOP 失 效 问题 (如 事务 不 起 作用 ) ， 再 回 
头 看 我 们 的 1.4 讨 论 的 。 








2.2、<mvc:view-controller path=”%" view-name="forward:/index"/> 表示 当 访 问 主页 时 自动 转 
发 到 index 控 制 器 。 


、 静 态 资 源 映射 


<!-- 当 在 web.xml 中 DispatcherServlet 使 用 <url-pattern>/</url-pattern> 映射 时 ， 能 映 
<mvc:default-servlet-handler/> 

<!-- 静态 资源 映射 - -> 

<mvc:resources mapping="/images/**" location="/WEB-INF/images/" /> 

<mvc:resources mapping="/css/**" lJocation="/WEB-INF/css/" /> 

<mvc:resources mapping="/js/**" location="/WEB-INF/js/" /> 


到 Eee = 


以 上 是 配置 文件 部 分 ， 接 下 来 来 看 具体 代码 。 





通用 DAO 层 Hibernate4 实 现 


为 了 减少 各 模块 实现 的 代码 量 ， 实 际 工作 时 都 会 有 通用 DAO 层 实现， 以 下 是 部 分 核心 代码 : 


public abstract class BaseHibernateDao<M extends java.io.Serializable, PK extends java.io 
protected static final Logger LOGGER = LoggerFactory.getLogger(BaseHibernateDao.class 


private final Class<M> entityClass; 

private final String HQL_LIST _ ALL; 

private final String HQL_COUNT_ALL; 

private final String HQL_OPTIMIZE_ PRE_LIST_ALL; 
private final String HQL_OPTIMIZE_ NEXT_LIST_ALL.; 
private String pkName = null; 


@Suppresswarnings("unchecked") 
public BaseHibernateDao() { 
this.entityClass = (Class<M>) ((ParameterizedType) getcClass().getGenericSuperclas 
Field[] fields = this.entityClass.getDeclaredFields(); 
for(Field f : fields) { 
if(f.isAnnotationpresent(Id.class)) { 
this.pkName = f.getName(); 
} 


} 


Assert.notNull(pkName); 
//TODO @Entity name not null 
HQL_LIST ALL = "from " + this.entityClass.getSimpleName() + " order by " + pkName 
HQL_OPTIMIZE_PRE_LIST_ALL = "from " + this.entityClass.getSimpleName() + " where 
HQL_OPTIMIZE_NEXT_LIST_ALL = "from " + this.entityClass.getSimpleName() + " where 
HQL_COUNT_ALL = " Select count(*) from " + this.entityClass.getSimpleName(); 

} 


@Autowired 
@Qualifier("sessionFactory") 
private SessionFactory sessionFactory; 


public Session getSession() { 


// 事 务必 须 是 开启 的 ， 否 则 获取 不 到 
return sessionFactory.getCurrentSession(); 





Spring3.1 集 成 Hibernate4 不 再 需要 HibernateDaoSupport 和 HibernateTemplate 了 ， 直接 使 用 
原生 API 即 可 。 


四 、 通 用 Service 层 代码 此 处 省 略 ， 看 源 代 码 ， 有 了 通用 代码 后 CURD 就 不 用 再 写 了 。 


@Service("UserService") 
public class UserServiceImpl extends BaseService<UserModel, Integer> implements UserServi 


private static final Logger LOGGER = LoggerFactory.getLogger(UserServiceImpl.class); 
private UserDao userDao; 


@Autowired 

@Qualifier("UserDao") 

Q@Override 

public void setBaseDao(IBaseDao<UserModel, Integer> userDao) { 
this.baseDao = userDao; 
this.userDao (UserDao) userDao; 


} 


Q@Override 
public Page<UserModel> query(int pn, int pageSize, UserQueryModel command) { 
return PageUtil.getPage(userDao.countQuery(command) ,pn, userDao.query(pn, pageSsi 





五 、 表 现 层 Controller 实 现 


采用 SpringMVC 支 持 的 REST 风 格 实现 ， 具 体 看 代码 ， 此 处 我 们 使 用 了 java Validator 框 架 来 
进行 表现 层 数 据 验 证 


在 Model 实 现 上 加 验证 注解 


@Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{username.illegal}") //java validat 
private String username; 


@NotEmpty(message = "{email.illegal}") 
@Email(message = "{email.illegal}") // 错 误 消息 会 自动 到 MessageSource 中 查找 
private String email; 


@Pattern(regexp = "[A-Za-z0-9]{5,20}", message = "{password.illegal}") 
private String password; 


@DateFormat( message="{register.date.error}")// 自 定义 的 验证 器 
private Date registerDate; 


国有 





在 Controller 中 相应 方法 的 需要 验证 的 参数 上 加 @Valid 即 可 


@RequestMapping(value = "/user/add", method = {RequestMethod.POST}) 
public String add(Model model, @ModelAttribute("command") @Valid UserModel command, B 


- 放 





六 、Spring 集 成 测试 


使 用 Spring 集 成 测试 能 很 方便 的 进行 Bean 的 测试 ， 而 且 使 用 
@TransactionConfiguration(transactionManager = "txManager", defaultRollback = true) 能 自 
动 回 滚 事务 ， 清 理 测试 前 后 状态 。 


@RuNWith(SpringJUnit4ClassRunner.class) 

@ContextCconfiguration(locations = {"classpath:spring-config.xml"}) 

@Transactional 

@TransactionCconfiguration(transactionManager = "txManager", defaultRollback = true) 
public class UserServiceTest { 


AtomicInteger counter = new AtomicInteger(); 


@Autowired 
private UserService userService,; 


其 他 部 分 请 直接 看 源码 ， 欢 迎 大 家 讨论 。 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/2625.html]】 


Spring Web MVC 中 的 页 面 绥 存 支持 一 一 跟 我 学 
SpringMVC 系列 


注 : 本 章 讲 的 是 Spring2 的 @Deprecated， 但 还 是 有 必要 提 一 下 。 跟 我 学 SpringMVC 系 
列 .| 


4.2、Controller 接 口 


package org.springframework.web,.servlet.mvce; 
public interface Controller { 
ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse respons 


EREEEEE 王 汪 间 





这 是 控制 器 接口 ， 此 处 只 有 一 个 方法 handleRequest， 用 于 进行 请 求 的 功能 处 理 ， 处 理 完 请 求 
后 返回 ModelAndView (Model 模 型 数据 部 分 和 View 视图 部 分 ) 。 


还 记得 第 二 章 的 HelloWorld 吗 ? 我 们 的 HelloWorldController 实 现 接口 ，Spring 默 认 提 供 了 一 
些 Controller 接 口 的 实现 以 方便 我 们 使 用 ， 有 具体 继承 体系 如 图 4-1 : 


、 WebContentGenerator 
用 于 提供 如 浏览 器 缓存 控制 、 是 否 必 须 有 session 开 局、 支持 的 请 求 方法 类 型 (GET、POST 
等 ) 等 ， 该 类 主要 有 如 下 属性 : 


Set<String> supportedMethods : 设置 支持 的 请 求 方法 类 型 ， 默 认 支 
持 “GET”"、“POST”"、“HEAD”， 如 果 我 们 想 支持 “PUT”*， 则 可 以 加 入 该 集合 “PUT”。 


boolean requireSession = false : 是 否 当 前 请 求 必须 有 session， 如 果 此 属性 为 ttue， 但 当前 
请 求 没有 打开 session 将 抛 出 HttpSessionRequiredException 弄 常 ; 


boolean useExpiresHeader = true : 是 否 使 用 HTTP1.0 协 议 过 期 响应 头 : 如 果 true 则 会 在 响 
应 头 添 加 :“Expires :”; 需要 配合 cacheSeconds 使 用 ; 


boolean useCacheControlHeader = true : 是 否 使 用 HTTP1.1 协 议 的 缓存 控制 响应 头 ， 如 果 
true 则 会 在 响应 头 添 加 ; 需要 配合 cacheSeconds 使 用 ; 


boolean useCacheControlNoStore = true : 是 否 使 用 HTTP 1.1 协 议 的 缓存 控制 响应 头 ， 如 
果 true 则 会 在 响应 头 添加 ; 需要 配合 cacheSeconds 使 用 ; 


private int cacheSeconds = -1 : 缓存 过 期 时 间 ， 正 数 表示 需要 缓存 ， 负 数 表示 不 做 任何 事 
情 (也 就 是 说 保留 上 次 的 缓存 设置 ) ， 


1、cacheSeconds =0 时 ， 则 将 设置 如 下 响应 头 数据 : 

Pragma : no-cache // HTTP 1.0 的 不 缓存 响应 头 

Expires : 1L // useExpiresHeader=true 时 ， HTTP 1.0 

Cache-Control : no-cache // useCacheControlHeader=true 时 ，HTTP 1.1 

Cache-Control : no-store // useCacheControlNoStore=true 时 ， 该 设置 是 防止 Firefox 绥 存 
2、cacheSeconds>0 时 ， 则 将 设置 如 下 响应 头 数据 : 


Expires : System.currentTimeMillis() + cacheSeconds * 1000L / useExpiresHeader=true 
时 ，HTTP 1.0 


Cache-Control : max-age=cacheSeconds // useCacheControlHeader=true 时 ，HTTP 1.1 
3、cacheSeconds<0 时 ， 则 什么 都 不 设置 ， 即 保留 上 次 的 缓存 设置 。 

此 处 简单 说 一 下 以 上 响应 头 的 作用 ， 缓 存 控制 已 超出 本 书 内 容 : 

HTTP1.0 缓 存 控制 响应 头 

Pragma : no-cache : 表示 防止 客户 端 缓存 ， 需 要 强制 从 服务 器 获取 最 新 的 数据 ; 


Expires : HTTP1.0 响 应 头 ， 本 地 副本 缓存 过 期 时 间 ， 如 果 客 户 端 发 现 缓存 文件 没有 过 期 则 不 
发 送 请 求 ，HTTP 的 日 期 间 必 须 是 格林 威 治 时 间 (GMT) ， 如 “Expires:Wed, 14 Mar 2012 
09:38:32 GMT”; 


HTTP1.1 缓 存 控制 响应 头 


Cache-Control : no-cache 强制 客户 端 每 次 请 求 获 取 服 务 器 的 最 新 版 本 ， 不 经 过 本 地 缓存 的 副 
本 了 验证; 


Cache-Control : no-store 强 制 客 户 端 不 保存 请 求 的 副本 ， 该 设置 是 防止 Firefox 缓 存 


Cache-Control : max-age=[ 秒 ] 客户 端 副本 缓存 的 最 长 时 间 ， 类 似 于 HTTP1.0 的 Expires， 只 
是 此 处 是 基于 请 求 的 相对 时 间 间 隔 来 计算 ， 而 非 绝 对 时 间 。 


还 有 相关 缓存 控制 机 制 如 LastModified (最 后 修改 时 间 验 证 ， 客 户 端的 上 一 次 请 求 时 间 在 服 
务 器 的 最 后 修改 时 间 之 后 ， 说 明 服务 器 数据 没有 发 生变 化 返回 304 状 态 码 ) 、ETag (没有 变 
化 时 不 重新 下 载 数据 ， 返 回 304) 。 


该 抽象 类 默认 被 AbstractController 和 WebContentlnterceptor 继 承 。 


4.4、AbstractController 


该 抽象 类 实现 了 Controller， 并 继承 了 WebContentGenerator ( 具有 该 类 的 特性 ， 有 具体 请 看 
4.3) ， 该 类 有 如 下 属性 


口 吕 


boolean synchronizeOnSession = false : 表示 该 控制 器 是 否 在 执行 时 同步 session， 从 而 
保证 该 会 话 的 用 户 串 行 访问 该 控制 器 。 


public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse respons 
// 委 托 给 WebContentGenerator 进 行 缓存 控制 
RE AS response, this instanceof LastModified); 
// 当 前 会 话 是 否 应 囊 行 化 访问 ， 
If (this.synchronizeOnSession) { 
HttpSession session = request.getSession(false); 
if (session != null) { 
Object mutex = WebUtils.getSessionMutex(session); 
synchronized (mutex) { 
return handleRequestIinternal(request, response); 
} 


} 
} 


return handleRequestIinternal(request, response); 





可 以 看 出 AbstractController 实 现 了 一 些 特殊 功能 ， 如 继承 了 WebContentGenerator 缓 存 控 制 
功能 ， 并 提供 了 可 选 人 会 话 的 串 行 化 访问 功能 。 而 且 提 供 了 handleRequestinternal 方 法 ， 因 
此 我 们 应 该 在 具体 的 控制 器 类 中 实现 handleRequestlnternal 方 法 ， 而 不 再 是 handleRequest。 


AbstractController 使 用 方法 : 


首先 让 我 们 使 用 AbstractController 来 重 写 第 二 章 的 HelloWorldController : 


public class HelloworldController extends AbstractController { 
Q@override 
protected ModelAndView handleRedquestInternal(HttpServletRedquest req, HttpServletRespo 
//1、 收 集 参数 
//2、 绑 定 参 数 到 命令 对 象 
//3、 调 用 业务 对 象 
//4、 选 择 下 一 个 页 面 
ModelAndView mv = new ModelAndView( ); 
// 添 加 模型 数据 可 以 是 任意 的 POJO 对 象 
mv.addobject("message", "Hello World!"); 
// 设 置 远 辑 视图 名 ， 视 图 解析 器 会 根据 该 名 字 解 析 到 具体 的 视图 页 面 
mv.setViewName("hello"); 
return mv; 








可 以 看 出 AbstractController 实 现 了 一 些 特殊 功能 ， 如 继承 了 WebContentGenerator 缓 存 控 制 
功能 ， 并 提供 了 可 选 会 话 的 串 行 化 访问 功能 。 而 且 提供 了 handleRequestlnternal 方 法 ， 因 
此 我 们 应 该 在 具体 的 控制 器 类 中 实现 handleRequestlnternal 方 法 ， 而 不 再 是 handleRequest。 


AbstractController 使 用 方法 : 


首先 让 我 们 使 用 AbstractController 来 重 写 第 二 章 的 HelloWorldController : 


public class HelloworldController extends AbstractController { 
Q@override 
protected ModelAndView handJleRedquestInternal(HttpServletRequest req, HttpServletRespo 
//1、 收 集 参数 
//2、 绑 定 参数 到 命令 对 象 
3 调用 业务 对 象 
//4、 选 择 下 一 个 页 面 
ModelAndView mv = new ModelAndView( ); 
// 添 加 模型 数据 可 以 是 任意 的 POJO 对 象 
mv.addobject("message", "Hello World!"); 
// 设 置 逻辑 视图 名 ， 视 图 解析 器 会 根据 该 名 字 解 析 到 具体 的 视图 页 面 
mv.setViewName("hello"); 
return mv; 











<! 一 在 chapter3-servlet .xml 配 置 处 理 器 --> 
<bean name="/hello" class="cn.javass.chapter3.web.controller.HelloworldController"/> 


从 如 上 代码 我 们 可 以 看 出 : 
1、 继 承 AbstractController 
2、 实 现 handleRequestlnternal 方 法 即 可 。 
直接 通过 response 写 响应 


如 果 我 们 想 直接 在 控制 器 通过 response 写 出 响应 呢 ， 以 下 代码 帮 我 们 阐述 : 


public class HelloworldwithoutReturnModelAndViewController extends AbstractController { 
Q@Override 
protected ModelAndView handleRequestIinternal(HttpServletRequest req, HttpServletRespo 


resp.getwriter().write("Hello | 
// 如 果 想 直接 在 该 处 理 器 /控制 器 写 响 应 可 以 通过 返回 nu1L1 告 诉 DispatcherSerVv1let 自 己 已 经 写 出 响应 了 
return null; 





<! 一 在 chapter3-servlet.xml 配 置 处 理 器 --> 


<bean name="/hellowithoutReturnModelAndView" class="cn.javass.chapter3.web.controller.Hel 
国 e 


从 如 上 代码 可 以 看 出 如 果 想 直接 在 控制 器 写 出 响应 ， 只 需要 通过 response 写 出 ， 并 返回 null 即 
可 。 





强制 请 求 方法 类 型 : 


<! 一 在 chapter3-serv1let.xml 配 置 处 理 器 --> 


<bean name="/hellowithPOST" class="cn.javass.chapter3.web.controller.HelloworldController 


<property name="supportedMethods" value="POST"></property> 
</bean> 


图 











以 上 配置 表示 只 支持 POST 请 求 ， 如 果 是 GET 请 求 客户 端 将 收 到 “HTTP Status 405 - Request 
method 'GET not supported” 


比如 注册 /登录 可 能 只 允许 POST 请 求 。 


当前 请 求 的 Session 前 置 条 件 检 查 ， 如 果 当 前 请 求 无 session 将 抛 出 
HttpSessionRequiredException 措 常 


<! 一 在 chapter3-servlet .xml 配 置 处 理 器 --> 
<bean name="/helloRequireSession" 


class="cn.javass.chapter3.web.controller.HelloworldController"> 


<property name="requireSession" value="true"/> 
</bean> 


在 进入 该 控制 器 时 ， 一 定 要 有 session 存在 ， 否 则 抛 出 HttpSessionRequiredException 异 常 。 


Session 同步 


即 同一 会 话 只 能 囊 行 访问 该 控制 器 。 


缓存 控制 : 


1、 缓存 5 秒 ，cacheSeconds=5 


package cn.javass.chapter3.web.controller; 
// 省 略 import 


public class HelloworldCacheController extends AbstractCcontroller { 
@Override 


protected ModelAndView handleRequestInternal(HttpServletRequest req, HttpServletRespo 
// 点 击 后 再 次 请 求 当前 页 面 


resp.getwriter().write("<a href=''>this</a>"); 
return null; 





<! 一 在 chapter3-servlet.xml 配 置 处 理 器 --> 


<bean name="/helloCache" 


class="cn.javass.chapter3.web.controller.HelloworldCacheController"> 
<property name="cacheSeconds" value="5"/> 
</bean> 


如 上 配置 表示 告诉 浏览 器 缓存 5 秒 钟 : 


开启 chrome 浏 览 器 调试 工具 : 


服务 器 返回 的 响应 头 如 下 所 示 : 


添加 了 “Expires:Wed, 14 Mar 2012 09:38:32 GMT” 和 "Cache-Control:max-age=5” 表 示人 允许 
客户 端 缓存 5 秒 ， 当 你 点 “this” 链 接 时 ， 会 发 现 如 下 : 


而 且 服 务 器 也 没有 收 到 请 求 ， 当 过 了 5 秒 后 ， 你 再 点 “this” 链 接 会 发 现 又 重新 请 求 服 务 器 下 载 新 
数据 。 


注 : 下 面 提 到 一 些 关于 缓存 控制 的 一 些 特殊 情况 


1、 对 于 一 般 的 页 面 跳 转 (如 超 链 接点 击 跳 转 、 通 过 js 调用 window.open 打 开 新 页 面 都 是 会 使 
用 浏览 器 缓存 的 ， 在 未 过 期 情况 下 会 直接 使 用 浏览 器 缓存 的 副本 ， 在 未 过 期 情况 下 一 次 请 求 
也 不 发 送 ) ; 


2、 对 于 刷新 页 面 (如 按 F5 键 刷新 ) ， 会 再 次 发 送 一 次 请 求 到 服务 器 的 ; 
2、 不 缓存 ，cacheSeconds=0 


<! 一 在 chapter3-servlet.xml 配 置 处 理 器 --> 


<bean name="/helloNoCache" 
class="cn.javass.chapter3.web.controller.HelloworldCacheController"> 
<property name="cacheSeconds" value="0"/> 

</bean> 


以 上 配置 会 要 求 浏览 器 每 次 都 去 请 求 服务 器 下 载 最 新 的 数据 : 


3、cacheSeconds<0， 将 不 添加 任何 数据 
响应 头 什 么 缓存 控制 信息 也 不 加 。 
4、Last-Modified 缓 存 机 制 


(1、 在 客户 端 第 一 次 输入 url 时 ， 服 务 器 端 会 返回 内 容 和 状态 码 200 表 示 请 求 成 功 并 返回 了 内 
容 ; 同时 会 添加 一 个 “Last-Modified” 的 响应 头 表 示 此 文件 在 服务 器 上 的 最 后 更 新 时 间 ， 
如 “Last-Modified:Wed, 14 Mar 2012 10:22:42 GMT" 表 示 最 后 更 新 时 间 为 (2012-03-14 10 : 
22) ; 


(2、 客 户 端 第 二 次 请 求 此 URL 时 ， 客 户 端 会 向 服务 器 发 送 请 求 头 “上 Modified-Since”， 询 问 
服务 器 该 时 间 之 后 当前 请 求 内容 是 否 有 被 修改 过 ， 如 “上 -Modified-Since: Wed, 14 Mar 2012 
10:22:42 GMT?”， 如 果 服 务 器 端的 内 容 没 有 变化 ， 则 自动 返回 HTTP 304 状 态 码 (只 要 响应 


头 ， 内 容 为 室 ， 这 样 就 节省 了 网 络 带宽 ) 。 
客户 端 强制 缓存 过 期 : 


(1、 可 以 按 ctrl+F5 强 制 刷 新 (会 添加 请 求 头 HTTP1.0 Pragma:no-cache 和 HTTP1.1 Cache- 
Control:no-cache 、If-Modified-Since 请 求 头 被 删除 ) 表示 强制 获取 服务 器 内 容 ， 不 缓存 。 


(2、 在 请 求 的 url 后 边 加 上 时 间 稚 来 重新 获取 内 容 ， 加 上 时 间 稚 后 浏览 器 就 认为 不 是 同一 份 内 


De 。 


容 : 
http://sishuok.com/?2343243243 和 http://sishuok.com/?34334344 是 两 次 不 同 的 请 求 。 
Spring 也 提供 了 Last-Modified 机 制 的 支持 ， 只 需要 实现 LastModified 接 口 ， 如 下 所 示 : 


package cn.javass.chapter3.web.controller 


public class HelloworldLastModifiedCacheController extends AbstractController implements 
private long lastModified; 
protected ModelAndView handleRequestIinternal(HttpServletRequest req, HttpServletRespo 
// 点 击 后 再 次 请 求 当前 页 面 
resp.getwriter().write("<a href=''>this</a>"); 
return null; 


public long getLastModified(HttpServletRequest request) { 
if(lastModified == 0L) { 
//TODO 此 处 更 新 的 条 件 : 如 果 内 容 有 更 新 ， 应 该 重新 返回 内 容 最 新 修改 的 时 间 戳 
lastModified = System.currentTimeMillis(); 


return lastModified; 





< 一 在 chapter3-servlet.xml 配 置 处 理 器 --> 


<bean name="/helloLastModified" 
class="cn.javass.chapter3.web.controller.HelloworldLastModifiedCacheController"/> 


HelloWorldLastModifiedCacheController 只 需要 实现 LastModified 接 口 的 getLastModified 方 
法 ， 保 证 当 内 容 发 生 改 变 时 返回 最 新 的 修改 时 间 即 可 。 


分 析 : 


(1、 发 送 请 求 到 服务 器 ， 如 (http://localhost:9080/springmvc- 
chapter3/helloLastModified) ， 则 服务 器 返回 的 响应 为 : 


(2、 再 次 按 F5 刷 新 客户 端 ， 返 回 状 态 码 304 表 示 服 务 器 没有 更 新 过 : 


(3、 重 局 服务 器 ， 再 次 刷新 ， 会 看 到 200 状 态 码 〈 因 为 服务 器 的 lastModified 时 间 变 了 ) 。 


Spring 判断 是 否 过 期 ， 通 过 如 下 代码 ， 即 请 求 的 “<f-Modified-Since” 大 于 等 于 当前 的 
getLastModified 方 法 的 时 间 惟 ， 则 认为 没有 修改 : 


this.notModified = (ifModifiedSince >= (lastModifiedTimestamp / 1000 * 1000)); 
5、ETag (实体 标记 ) 缓存 机 制 


(1 :浏览 器 第 一 次 请 人 服务 器 在 响应 时 给 请 求 URL 标 记 ， 并 在 HTTP 响 应 头 中 将 其 传送 到 
客户 端 ， 类 似 服务 器 端 返 回 的 格式 :“ETag:"0f8b0c86fe2c0c7a67791e53d660208e3” 


(2 :浏览 器 第 二 次 请 求 ， 客 户 端的 查询 更 新 格式 是 这 样 的 : “|f-None- 
Match:"0f8b0c86fe2c0c7a67791e53d660208e3"”"， 如 果 ETag 没 改变 ， 表 示 内 容 没 有 发 生 改 
变 ， 则 返回 状态 304 。 


Spring 也 提供 了 对 ETag 的 支持 ， 具 体 需 要 在 web.Xxml 中 配置 如 下 代码 : 


<filter> 
<filter-name>etagFilter</filter-name> 
<filter-class>org.springframework.web.filter.ShallowEtagHeaderFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>etagFilter</filter-name> 
<servlet-name>chapter3</servlet-name> 
</filter-mapping> 


过 滤器 只 过 滤 到 我 们 DispatcherServlet 的 请 求 。 


~ 


1) : 发 送 请 求 到 服务 器 :“http://localhost:9080/springmvc-chapter3/hello”， 服 务 器 返回 的 响 
应 头 中 添加 了 (ETag:"0f8b0c86fe2c0c7a67791e53d660208e3") 


2) :浏览 器 再 次 发 送 请 求 到 服务 器 ( 按 F5 刷 新 ) ， 请 求 关中 添加 了 “lf-None-Match: 


"Of8b0c86fe2c0c7a67791e53d660208e3"”， 响 应 返回 304 人 代码， 表示 服务 器 没有 修改 ， 并 且 
响应 头 再 次 添加 了 “ETag:"0f8b0c86fe2c0c7a67791e53d660208e3"” (每 次 都 需要 计算 ) 


那 服务 器 端 是 如 何 计 算 ETag 的 呢 ? 


protected String generateETagHeaderValue(byte[] bytes) { 
StringBuilder builder = new StringBuilder("\"0"); 
DigestUtils.appendMd5SDigestAsHex(bytes, builder); 
builder.append('"'); 
return builder.toString(); 


bytes 是 response 要 写 回 到 客户 端的 响应 体 〈 即 响应 的 内 容 数 据 ) ， 是 通过 MD5 算 法 计算 的 内 
容 的 摘要 信息 。 也 就 是 说 如 果 服 务 器 内 容 不 发 生 改 变 ， 则 ETag 每 次 都 是 一 样 的 ， 即 服务 器 端 
的 内 容 没 有 发 生 改 变 。 

此 处 只 列举 了 部 分 缓存 控制 ， 详 细 介 绍 超出 了 本 书 的 范围 ， 强 烈 推 

荐 : http://www.mnot.net/cache_docs/ (中 文 

版 http://www.chedong.com/tech/cache_docs.html) 详细 了 解 HTTP 缓 存 控制 及 为 什么 要 
缓存 。 

缓存 的 目的 是 减少 相应 延迟 和 减少 网 络 带 宽 消 耗 ， 比 如 css、js、 图 片 这 类 静态 资源 应 该 进 

行 缓存 。 


实际 项 目 一 般 使 用 反 向 代理 服务 器 (如 nginx、apache 等 ) 进行 缓存 。 


Spring3 Web MVC 下 的 数据 类 型 转换 (第 一 篇 ) 
一 一 《 跟 我 学 Spring3 Web MVC》 抢 先 看 


基于 spring-framework-3.1.1.RELEASE 


7.1、 简 介 
在 编写 可 视 化 界面 项 目 时 ， 我 们 通常 需要 对 数据 进行 类 型 转换 、 验 证 及 格式 化 。 


一 、 在 Spring3 之 前 ， 我 们 使 用 如 下 架构 进行 类 型 转换 、 验 证 及 格式 化 : 


(DretAsText 





一》 
加 Spring 的 
String BezetAsText PropettyEditor bect a 


流程 : 


@ : 类 型 转换 : 首先 调用 PropertyEditor 的 setAsText (String) ， 内 部 根据 需要 调用 
setValue(Object) 方 法 进行 设置 转换 后 的 值 ; 


@ : 数据 验证 : 需要 显示 调用 Spring 的 Validator 接 口 实现 进行 数据 验证 ; 
@ : 格式 化 显示 : 需要 调用 PropertyEditor 的 getText 进 行 格式 化 显示 。 
使 用 如 上 架构 的 缺点 是 : 


> 任 








(1、PropertyEditor 被 设计 为 只 能 String< 一 一 >Object 之 间 转 换 ， 不 能 任意 对 象 类 型 < 
意 类 型 ， 如 我 们 常见 的 Long 时 间 改 到 Date 类 型 的 转换 是 办 不 到 的 ; 


(2、PropertyEditor 是 线程 不 安全 的 ， 也 就 是 有 状态 的 ， 因 此 每 次 使 用 时 都 需要 创建 一 个 ， 
不 可 重用 ; 


(3、PropertyEditor 不 是 强 类 型 的 ，setValue (Object) 可 以 接受 任意 类 型 ， 因 此 需要 我 们 自 
己 判 断 类 型 是 否 兼容 ; 


(4、 需 要 自己 编程 实现 验证 ，Spring3 支 持 更 棒 的 注解 验证 支持 ; 
(5、 在 使 用 SpEL 表 达 式 语言 或 DataBinder 时 ， 只 能 进行 String<--->Object 之 间 的 类 型 转换 ; 
(6 、 不 支持 细 粒 度 的 类 型 转换 /格式 化 ， 如 UserModel 的 registerDate 需 要 转换 /格式 化 类 似 %``2012-05-01、`“d 


** 在 Spring Web MVC 环 境 中 ， 数 据 类 型 转换 、 验 证 及 格式 化 通常 是 这 样 使 用 的 : ** 


WebDataBin der 


(DsetAsText 


表单 数据 i Propeity Editor 


- - 3 BindingResult 
<sbfing:'bin 中 









Spfing 的 Validator 





<form:form> 
<form.: errors> 





流程 : 

GD、 类 型 转换 : 首先 表单 数据 (全 部 是 字符 串 ) 通过 WebDataBinder 进 行 绑 定 到 命令 对 象 ， 内 部 通过 PropertyEditor 实 
@ : 数据 验证 : 在 控制 器 中 的 功能 处 理 方 法 中 ， 需 要 显示 的 调用 Spring 的 Validator 实 现 并 将 错 
误 信 息 添加 到 BindingResult 对 象 中 ; 

四 : 格式 化 显示 : 在 表单 页 面 可 以 通过 如 下 方式 展示 通过 PropertyEditor 格式 化 的 数据 和 错 


误 信 息 : 


<%@taglib prefix="spring" uri="http://www.springframework.org/tags" %> 
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 


首先 需要 通过 如 上 taglib 指 令 引 入 spring 的 两 个 标签 库 。 


//I、 格 式 化 单个 命令 /表单 对 象 的 值 (好 像 比较 麻烦 ， 昊 心 没有 好 办 法 ) 
<spring:bind path="dataBinderTest.phoneNumber">${status.value}</spring:bind> 


//2、<spring:eval> 标 签 ， 自 动 调用 ConversionService 并 选择 相应 的 Converter SPI 进 行 格式 化 展示 
<spring:eval expression="dataBinderTest.phoneNumber"></spring:eval> 


如 上 代码 能 工作 的 前 提 是 在 RequestMappingHandlerMapping 配 置 了 
ConversionServiceExposinglnterceptor， 它 的 作用 是 暴露 conversionService 到 请 求 中 以 便 如 
<spring:eval> 标 签 使 用 。 
//3、 通 过 form 标 签 ， 内 部 的 表单 标签 会 自动 调用 命令 /表单 对 象 属性 对 应 的 PropertyEditor 进 行 格 式 化 显示 
<form:form commandName="dataBinderTest"> 


<form:input path="phoneNumber"/><!-- 如 果 出 错 会 显示 错误 之 前 的 数据 而 不 是 空 --> 
</form:form> 


//4、 显 示 验 证 失败 后 的 错误 信息 
<form:errors></form:errors> 


接 下 来 我 们 就 详细 学 习 一 下 这 些 知识 吧 。 


7.2、 数 据 类 型 转换 


7.2.1、Spring3 之 前 的 PropertyEditor 
PropertyEditor 介 绍 请 参考 【4.16.1、 数 据 类 型 转换 】。 
一 、 测 试 之 前 我 们 需要 准备 好 测试 环境 : 


(1、 模 型 对 象 ， 和 【4.16.1、 数 据 类 型 转换 】 使 用 的 一 样 ， 需 要 将 DataBinderTestModel 模 型 
类 及 相关 类 找 贝 过 来 放 入 cn.javass.chapter7.model 包 中 。 


package cn.javass.chapter7 .web.controller; 
// 省 略 import 
@Controller 
public class DataBinderTestController { 
@RequestMapping(value = "/dataBind") 
public String test(DataBinderTestModel command) { 
// 输 出 command 对 象 看 看 是 否 绑 定 正确 
System.out.println(command); 
model.addAttribute("dataBinderTest", command); 
return "bind/success"; 


(3、Spring 配 置 文件 定义 ， 请 参考 chapter7-servlet.xml， 并 注册 DataBinderTestController : 


<bean cJlass="cn,javass,chapter7.web.controller.DataBinderTestController"/> 


(4、 测 试 的 URL : 


http://localhost:9080/springmvc-chapter7/dataBind? 
username=zhang&bool=yes&schoolnfo.specialty=computer&hobbyList[0]=program&hobbytLi 
st[1]=music&map[key1]=value1&map[key2]=value2&phoneNumber=010- 
12345678&date=2012-3-18 16:48:48&state=blocked 


二 、 注 解 式 控制 器 注册 PropertyEditor : 
1、 使 用 WebDataBinder 进 行 控制 器 级 别 注 册 PropertyEditor (控制 器 独 享 ) 


@InitBinder 

// 此 处 的 参数 也 可 以 是 ServletRequestDataBinder 类 型 

public void initBinder(WebDataBinder binder) throws Exception { 
// 注 册 自 定义 的 属性 编辑 器 
//1、 日 期 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
CustomDateEditor dateEditor = new CustomDateEditor(df, true); 
// 表 示 如 果 命 令 对 象 有 Date 类 型 的 属性 ， 将 使 用 该 属性 编辑 器 进行 类 型 转换 
binder.registerCustomEditor(Date.class, dateEditor); 
// 自 定义 的 电话 号 码 编辑 器 (和 【4.16.1、 数 据 类 型 转换 】 一 样 ) 
binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); 


和 【4.16.1、 数 据 类 型 转换 】 一 节 类 似 ， 只 是 此 处 需要 通过 @InitBinder 来 注册 自 定义 的 
PropertyEditor 。 


2、 使 用 **webBindingInitializer 批 量 注册 ** PropertyEditor 


和 【4.16.1、 数 据 类 型 转换 】 不 太一 样 ， 因 为 我 们 的 注解 式 控 制 器 是 POJO， 没 有 实现 任何 东 
西 ， 因 此 无 法 注入 WebBindinglnitializer ， 此 时 我 们 需要 把 WebBindinglnitializer 注 入 到 我 们 的 
RequestMappingHandlerAdapter 或 AnnotationMethodHandlerAdapter， 这 样 对 于 所 有 的 注解 
式 控制 器 都 是 共享 的 。 


<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerA 
<property name="webBindingInitializer"> 
<bean class="cn.javass.chapter7 .web.controller.support.initializer .MywebBindingIn 
</property> 
</bean> 


到 二 = 一 


此 时 我 们 注释 掉 控 制 器 级 别 通过 @InitBinder 注 册 PropertyEditor 的 方法 。 





3、 全 局 级 别 注 册 PropertyEditor (全 局 共享 ) 


和 【4.16.1、 数 据 类 型 转换 】 一 节 一 样 ， 此 处 不 再 重复 。 请 参考 【4.16.1、 数 据 类 型 转换 】 的 
【全 局 级 别 注册 PropertyEditor (全 局 共享 ) 】 。 


接 下 来 我 们 看 一 下 Spring3 提 供 的 更 强大 的 类 型 转换 支持 。 


7.2.2、Spring3 开 始 的 类 型 转换 系统 


Spring3 引 入 了 更 加 通用 的 类 型 转换 系统 ， 其 定义 了 SPI 接 口 (Converter 等 ) 和 相应 的 运行 时 
执行 类 型 转换 的 API〈ConversionService 等 ) ， 在 Spring 中 它 和 PropertyEditor 功 能 类 似 ， 可 
以 替代 PropertyEditor 来 转换 外 部 Bean 属 性 的 值 到 Bean 属 性 需要 的 类 型 。 


该 类 型 转换 系统 是 Spring 通用 的 ， 其 定义 在 org.springframework.core.convert 包 中 ， 不 仅仅 在 
Spring Web MVC 场 景 下 。 目 标 是 完全 替换 PropertyEditor， 提 供 无 状态 、 强 类 型 且 可 以 在 任 
意 类 型 之 间 转 换 的 类 型 转换 系统 ， 可 以 用 于 任何 需要 的 地 方 ， 如 SpEL、 数 据 绑 定 。 


Converter SPI 完 成 通用 的 类 型 转换 逻辑 ， 如 java.util.Date<---->java.lang.Long 或 
java.lang.String---->PhoneNumberModel 等 。 


7.2.2.1、 架 构 
、 类 型 转换 器 : 提供 类 型 转换 的 实现 支持 。 


了 Converter | DGenericConverter DConverterFactoryS, R> 
地 convert (S) T 了 convert (Object, TypeDescriptor, TypeDescriptor) Object uy EetConverter (Class<T») Converter <S, T> 


IB) convertiblelypes Set ConvertiblePair> 


全 


| 
也 CoenditionalGenericConverter 


ow matches (TypeDescriptor, TypeDescriptor) boole an 


一 个 有 如 下 三 种 接口 : 


(1、Converter : 类 型 转换 器 ， 用 于 转换 S 类 型 到 T 类 型 ， 此 接口 的 实现 必须 是 线程 安全 的 且 
可 以 被 共享 。 
package org.springframework.core.convert.converter,; 


public interface Converter<S，T> { //G) S 是 源 类 型 T 是 目标 类 型 
T convert(S source); //@ 转换 S 类 型 的 Source 到 T 目 标 类 型 的 转换 方法 


} 


示例 : 请 参考 cn.javass.chapter7.converter.support.StringToPhoneNumberConverter 转 换 
器 ， 用 于 将 String--->PhoneNumberModel。 


了 


此 处 我 们 可 以 看 到 Converter 接 口 实现 只 能 转换 一 种 类 型 到 另 一 种 类 型 ， 不 能 进行 多 类 型 转 
换 ， 如 将 一 个 数组 转换 成 集合 ， 如 (String[] ----> List<String>、String[]----- 
>List<PhoneNumberModel> 等 ) 。 


(2、GenericConverter 和 ConditionalGenericConverter : GenericConverter 接 口 实现 能 在 
多 种 类 型 之 间 进 行 转换 ，ConditionalGenericConverter 是 有 条 件 的 在 多 种 类 型 之 间 进 行 转换 。 


package org.springframework.core.convert.converter; 
public interface GenericConverter { 
Set<ConvertiblePair> getConvertibleTypes(); 
Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType); 


二 了 | 
getConvertibleTypes: 指 定 了 可 以 转换 的 目标 类 型 对 ; 


convert : 在 sourceType 和 targetType 类 型 之 间 进 行 转换 。 


package org.springframework.core.convert.converter; 
public interface ConditionalGenericConverter extends GenericConverter { 
boolean matches(TypeDescriptor sourceType, TypeDescriptor targetType); 


} 


matches : 用 于 判断 sourceType 和 targetType 类 型 之 间 能 否 进 行 类 型 转换 。 


示例 : 如 org.springframework.core.convert.support.ArrayToCollectionConverter 和 
CollectionToArrayConverter 用 于 在 数组 和 集合 间 进 行 转换 的 ConditionalGenericConverter 实 
现 ， 如 在 String[]<---->List<String>、String[]<---->List<PhoneNumberModel> 等 之 间 进 行 类 型 


转换 。 


对 于 我 们 大 部 分 用 户 来 说 一 般 不 需要 自 定 义 GenericConverter 如 果 需 要 可 以 参考 内 置 的 
GenericConverter 来 实现 自己 的 。 


(3、ConverterFactory : 工厂 模式 的 实现 ， 用 于 选择 将 一 种 S 源 类 型 转换 为 R 类 型 的 子 类 型 下 
的 转换 器 的 工厂 接口 。 


package org,springframework.core.convert ,converter ; 
public interface ConverterFactory<S，R> { 
<T extends R> Converter<S，T> getConverter(Class<T> targetType); 


S : 源 类 型 ; 民 目 标 类 型 的 父 类 型 ;TT : 目标 类 型 ， 且 是 民 类 型 的 子 类 型 ; 
getConverter : 得 到 目标 类 型 的 对 应 的 转换 器 。 


示例 : 如 org.springframework.core.convert.support.NumberToNumberConverterFactory 用 于 
在 Number 类 型 子 类 型 之 间 进 行 转换 ， 如 Integer--->Double ，Byte---->Integer ， Float--- 
>Double 等 。 


对 于 我 们 大 部 分 用 户 来 说 一 般 不 需要 自 定义 ConverterFactory， 如 果 需 要 可 以 参考 内 置 的 
ConverterFactory 来 实现 自己 的 。 

2、 类 型 转换 器 注册 器 、 类 型 转换 服务 : 提供 类 型 转换 器 注册 支持 ， 运 行 时 类 型 转换 API 支 
持 。 
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一 共有 如 下 两 种 接口 : 


(1、ConverterRegistry : 类 型 转换 器 注册 支持 ， 可 以 注册 /删除 相应 的 类 型 转换 器 。 


package org.springframework.core.convert ,converter ; 
public interface ConverterRegistry { 
void addConverter(Converter<?, ?> converter); 
void addConverter(Class<?> sourceType, Class<?> targetType, Converter<?, ?> converter 
void addConverter(GenericConverter converter); 
void addConverterFactory(ConverterFactory<?, ?> converterFactory); 
void removeConvertible(Class<?> sourceType, Class<?> targetType); 


} 
国 二 








可 以 注册 : Converter 实 现 ，GenericConverter 实 现 ，ConverterFactory 实 现 。 


(2、ConversionService : 运行 时 类 型 转换 服务 接口 ， 提 供 运 行 期 类 型 转换 的 支持 。 


package org,springframework.core.convert ; 
public interface ConversionService { 
boolean canConvert(Class<?> sourceType, Class<?> targetType); 
boolean canConvert(TypeDescriptor sourceType, TypeDescriptor targetType); 
<T> T convert(Object source, Class<T> targetType); 
Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType); 


} 
二 | 
convert : 将 源 对 象 转换 为 目标 类 型 的 目标 对 象 。 
Spring 提供 了 两 个 默认 实现 (其 都 实现 了 ConverterRegistry、ConversionService 接 口 ) : 
DefaultConversionService: 默 认 的 类 型 转换 服务 实现 ; 
DefaultFormattingConversionService : 带 数 据 格式 化 支持 的 类 型 转换 服务 实现 ， 一 般 使 用 该 
服务 实现 即 可 。 
7.2.2.2、Spring 内 建 的 类 型 转换 器 如 下 所 示 : 

类 名 说 明 
第 一 组 : 标量 转换 器 


String----->Booleantrue:true/on/yes/1 ; 


StringToBooleanConverter foalse ralse/ ono 


ObjectToStringConverter Object----->String 调 用 toString 方 法 转换 
StringToNumberConverterFactory String----->Number (如 Integer、Long 等 ) 





Number 子 类 型 (Integer、Long、Double 等 )< 


NumberToNumberConverterFactory > NUmiber 字 类 型 (Integer Larigs Double 等 ) 


1 站 站 -~---- 芭 7 全 AA a pA ~ 
StringToCharacterConverter a >java.lang.Character 取 字符 串 第 一 个 字 


> 





Number 子 类 型 (Integer、Long、Double 等 ) 


NumberToCharacterConverter 
java.lang.Character 


java.lang.Character >Number 子 类 型 
(Integer、Long、Double 等 ) 





CharacterToNumberFactory 


StringJoEnumConverterFactory 


EnumToStringConverter 


StringToLocaleConverter 


PropertiesToStringConverter 


StringToPropertiesConverter 


第 二 组 : 集合 、 数 组 相关 转换 器 
ArrayToCollectionConverter 
CollectionToArrayConverter 


ArrayToArrayConverter 
CollectionToCollectionConverter 


MapToMapConverter 
ArrayToStringConverter 


StringToArrayConverter 


ArrayToObjectConverter 


ObjectToArrayConverter 


Collection ToStringConverter 


StringToCollectionConverter 


Collection ToObjectConverter 


ObjectToCollectionConverter 


第 三 组 : 默认 (fallback) 转换 器 : 


之 前 的 转换 器 不 能 转换 时 调用 


ObjectToObjectConverter 


ldToEntityConverter 


FallbackObjectToStringConverter 


/Dr A 大 


String----->enum 类 型 通过 Enum.valueOf 将 字符 
串 转 换 为 需要 的 enum 类 型 


enum 类 型 ----->String 返 回 enum 对 象 的 name() 值 
String----->java.util.Local 


java.util.Properties----->String 默 认 通 过 1SO- 
8859-1 解 码 


String----->java.util.Properties 默 认 使 用 |SO- 
8859-1 编 码 


任意 S 数 组 ----> 任 意 T 集 合 (List、Set) 
任意 TT 集合 (List、Set) ----> 任 意 S 数 组 
任意 S 数 组 <----> 任 意 T 数 组 


任意 TT 集合 (List、Set) <----> 任 意 T 集 合 (List、 
Set) 即 集 合 之 间 的 类 型 转换 


Map<---->Map 之 间 的 转换 
任意 S 数 组 ---->String 类 型 


String-----> 数 组 默认 通过 “,” 分 割 ， 且 去 除 字符 囊 
的 两 边 空格 (trim) 

任意 S 数 组 ----> 任 意 Object 的 转换 (如 果 目 标 类 型 
和 源 类 型 兼容 ， 直 接 返回 源 对 象 ; 否则 返回 S 数 
组 的 第 一 个 元 素 并 进行 类 型 转换 ) 


Object-----> 单 元 素数 组 
任意 T 集 合 (List、Set) ---->String 类 型 


String-----> 集 合 (List、Set) 默认 通过 “, "分割 ， 
且 去 除 字符 串 的 两 边 空 格 (trim) 


任意 T 集 合 ----> 任 意 Object 的 转换 (如 果 目 标 类 型 
和 源 类 型 兼容 ， 直 接 返回 源 对 象 ; 否则 返回 S 数 
组 的 第 一 个 元 素 并 进行 类 型 转换 ) 


Object-----> 单 元 素 集合 


Object (S) ----- >Object (T) 首先 党 试 valueOf 
进行 转换 、 没 有 则 尝试 new 构造 器 (S) 


Id(S)----->Entity(T) 查 找 并 调用 public static TT 
findEntityName 获 取 目 标 对 象 ，EntityName 是 T 类 
型 的 简单 类 型 


Object----->StringConversionService 作 为 恢复 使 
用 ， 即 其 他 转换 器 不 能 转换 时 调用 (执行 对 象 的 


toString() 方 法 ) 
S : 代表 源 类 型 ，T : 代表 目标 类 型 


如 上 的 转换 器 在 使 用 转换 服务 实现 DefaultConversionService 和 
DefaultFormattingConversionService 时 会 自动 注册 。 


7.2.2.3、 示 例 


(1、 自 定义 String----->PhoneNumberModel 的 转换 器 


package cn.javass.chapter7 .web.controller.support.converter; 
// 省 略 import 
public class StringToPhoneNumberConverter implements Converter<String, PhoneNumberModel> 
Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); 
Q@override 
public PhoneNumberModel convert(String source) { 
if(!StringUtils.hasLength(source)) { 
//(D 如 果 source 为 空 返回 null 
return null; 
} 
Matcher matcher = pattern.matcher(source); 
if(matcher.matches()) { 
// 避 如 果 匹 配 进行 转换 
PhoneNumberModel] phoneNumber = new PhoneNumberModel(); 
phoneNumber .setAreaCode(matcher .group(1)); 
phoneNumber .setPhoneNumber(matcher .group(2)); 
return phoneNumber; 
} else { 
//(@ 如 果 不 匹 配 转换 失败 
throw new IllegalArgumentException(String.format(" 类 型 转换 失败 ， 需 要 格式 [010-123< 





String 转 换 为 Date 的 类 型 转换 器 ， 请 参考 
cn.javass.chapter7.web.controllersupport.converter StringToDateConverter ° 


(2、 测 试用 例 (cn.javass.chapter7.web.controller.support.converter.ConverterTest) 


@Test 

public void testStringToPhoneNumberConvert() { 
DefaultConversionService conversionService = new DefaultConversionService(); 
conversionService.addConverter(new StringToPhoneNumberConverter()); 


String phoneNumberStr = "010-12345678"; 
PhoneNumberModel phoneNumber = conversionService.convert(phoneNumberStr, PhoneNumberM 


Assert.assertEquals("010", phoneNumber .getAreaCode()); 


ES 


类 似 于 PhoneNumberEditor 将 字符 串 “010-12345678" 转 换 为 PhoneNumberModel 。 





@Test 
public void testOtherConvert() { 
DefaultConversionService conversionService = new DefaultConversionService(); 


//"1"--->true (字符 囊 41” 可 以 转换 为 布尔 值 true) 
Assert.assertEquals(Boolean.valueof(true), conversionService.convert("1", Boolean.cla 


//"1,2,3,4"--->List (转换 完毕 的 集合 大 小 为 4) 


Assert.assertEquals(4, conversionService,.convert("1,2,3,4", List.class).size()); 


} 
国 = 


其 他 类 型 转换 器 使 用 也 是 类 似 的 ， 此 处 不 再 重复 。 








7.2.2.4、 集 成 到 Spring Web MVC 环 境 


忆 


(1、 注 册 ConversionService 实 现 和 自 定 义 的 类 型 转换 器 


<1-- 四 注册 ConversionService --> 
<bean id="conversionService" class="org.springframework.format.support. 
FormattingConversionServiceFactory 
<property name="converters"> 
<list> 
<bean class="cn.javass.chapter7 .web.controller.support. 
converter.StringToPhoneNumberConverter"/> 
<bean class="cn.javass.chapter7 .web.controller.support. 
converter.StringToDateConverter"> 
<constructor-arg value="yyyy-MM-dd"/> 
</bean> 
</list> 
</property> 
</bean> 


国定 = 





FormattingConversionServiceFactoryBean : 是 FactoryBean 实 现 ， 默 认 使 用 
DefaultFormattingConversionService 转 换 器 服务 实现 ; 


converters : 注册 我 们 自 定 义 的 类 型 转换 器 ， 此 处 注册 了 String--->PhoneNumberModel 和 
String--->Date 的 类 型 转换 器 。 


(2、 通 过 ConfigurableWebBindinglnitializer 注 册 ConversionService 


<1-- @@ 使 用 ConfigurablewebBindingInitializer 注 册 conversionService --> 
<bean id="webBindingInitializer" class="org.springframework.web.bind.support. 
ConfigurablewebBi 
<property name="conversionService" ref="conversionService"/> 
</bean> 


国王 一 





此 处 我 们 通过 ConfigurableWebBindinglnitializer 绑 定 初始 化 器 进行 ConversionService 的 注 
册 ; 


3、 注 册 ConfigurableWebBindinglnitializer 到 RequestMappingHandlerAdapter 


<bean class="org.springframework.web.servlet.mvc.method.annotation. 


RequestMappingHandlerAdapter" 
<property name="webBindingInitializer" ref="webBindingInitializer"/> 
</bean> 


图 本 











过 如 上 配置 ， 我 们 就 完成 了 Spring3.0 的 类 型 转换 系统 与 Spring Web MVC 的 集成 。 此 时 可 
局 


以 启动 服务 器 输入 之 前 的 URL 测 试 了 。 


此 时 可 能 有 人 会 问 ， 如 果 我 同时 使 用 PropertyEditor 和 ConversionService， 执 行 顺序 是 什么 
呢 ? 内 部 首先 查找 PropertyEditor 进 行 类 型 转换 ， 如 果 没 有 找到 相应 的 PropertyEditor 再 通过 
ConversionService 进 行 转换 。 


如 上 集成 过 程 看 起 来 比较 麻烦 ， 后 边 我 们 会 介绍 <mvc:annotation-driven> 和 
@EnableWebMvc，ConversionService 会 自动 注册 ， 后 续 章 节 再 详细 介绍 。 


Spring3 Web MVC 下 的 数据 格式 化 (第 二 篇 ) 
一 一 《 跟 我 学 Spring3 Web MVC》 抢 先 看 


基于 spring-framework-3.1.1.RELEASE 


7.3、 数 据 格 式 化 


在 如 Web /客户 端 项 目 中 ， 通 常 需要 将 数据 转换 为 具有 某 种 格式 的 字符 串 进 行 展 示 ， 因 此 上 节 
我 们 学 习 的 数据 类 型 转换 系统 核心 作用 不 是 完成 这 个 需求 ， 因 此 Spring3 引 入 了 格式 化 转换 器 
(Formatter SPI) 和 格式 化 服务 API (FormattingConversionService) 从 而 支持 这 种 需求 。 
在 Spring 中 它 和 PropertyEditor 功 能 类 似 ， 可 以 替代 PropertyEditor 来 进行 对 象 的 解析 和 格式 

化 ， 而 且 支 持 细 粒 度 的 字段 级 别 的 格式 化 /解析 。 


Formatter SPI 核 心 是 完成 解析 和 格式 化 转换 逻辑 ， 在 如 VWeb 应 用 /客户 端 项 目 中 ， 需 要 解析 、 
打印 /展示 本 地 化 的 对 象 值 时 使 用 ， 如 根据 Locale 信 息 将 java.util.Date---->java.lang.String 打 
印 /展示 、java.lang.String---->java.util.Date 等 。 


该 格式 化 转换 系统 是 Spring 通 用 的 ， 其 定义 在 org.springframework.format 包 中 ， 不 仅仅 在 
Spring Web MVC 场 景 下 。 


7.3.1、 架 构 


1、 格 式 化 转换 器 : 提供 格式 化 转换 的 实现 支持 。 


UPrinter<I> | DParser IT> | DAnnotationFormatterFactoryC...> 


WB print 0, Locale) String WD parse Gtring, Locale) T BD getFieldlypes() Set<Class<?> 


Ey BetPrinter (A Class<?)) Erinter<?》 
mm getParser (A Class?)) Par ser ?> 


UFormatter <T> 





一 共有 如 下 两 组 四 个 接口 : 
(1、Printer 接 口 : 格式 化 显示 接口 ， 将 T 类 型 的 对 象 根据 Locale 信 息 以 某 种 格式 进行 打印 显 


示 ( 即 返回 字符 囊 形式 ) ; 


package org.springframework.format; 
public interface Printer<T> 

String print(T object, Locale locale); 
} 


(2、Parser 接 口 : 解析 接口 ， 根 据 Locale 信 息 解 析 字 符 串 到 T 类 型 的 对 象 ; 


package org.springframework .format 
public interface Parser<T> { 
T parse(String text, Locale locale) throws ParseException; 


解析 失败 可 以 抛 出 java.text.ParseException 或 legalArgumentException 异 常 即 可 。 


(3、Formatter 接 口 : 格式 化 SP| 接 口 ， 继 承 Printer 和 Parser 接 口 ， 完 成 T 类 型 对 象 的 格式 化 
和 解析 功能 ; 


package org.springframework.format; 
public interface Formatter<T> extends Printer<T>, Parser<T> { 


} 


(4、AnnotationFormatterFactory 接 口 : 注解 驱动 的 字段 格式 化 工厂 ， 用 于 创建 带 注解 的 
对 象 字 段 的 Printer 和 Parser， 即 用 于 格式 化 和 解析 带 注 解 的 对 象 字段 。 


package org.springframework.format; 

public interface AnnotationFormatterFactory<A extends Annotation> {//Q 可 以 识别 的 注解 类 型 
Set<Class<?>> getFieldTypes();//@ 可 以 被 A 注解 类 型 注解 的 字段 类 型 集合 
Printer<?> getPrinter(A annotation，Class<?> fieldType);//(3 根 据 A 注 解 类 型 和 fieldType 类 型 
Parser<?> getParser(A annotation，Class<?> fieldType);// 了 根据 A 注解 类 型 和 fieldType 类 型 获 | 





返回 用 于 格式 化 和 解析 被 A 注解 类 型 注解 的 字段 值 的 Printer 和 Parser。 如 
JodaDateTimeFormatAnnotationFormatterFactory 可 以 为 带 有 @DateTimeFormat 注 解 的 
java.util.Date 字 段 类 型 创建 相应 的 Printer 和 Parser 进 行 格式 化 和 解析 。 

2、 格 式 化 转换 器 注册 器 、 格 式 化 服务 : 提供 类 型 转换 器 注册 支持 ， 运 行 时 类 型 转换 API 支 
持 。 


DConverterRegistry 











ed Printer > | @ Parser > | 
ee 
| 注册 格式 化 转换 器 SB 
(DFormatterRegistry | | \ 
F BFornatter CI> 
站 “】 。。” @ 使 用 格式 化 转换 器 进行 格式 化 


ID FormattineConversionService 
i a a mm JU AnmotationFormatterFactory<...> | 


| DB eetFieldTypes() Set<Class<?)> | 
geetPrinter (A Class<?>) Printer<?> 








IO) DefaultFormattineConversionService 
me 哩 eetParser (A, Class<?)) Parser<?> | 








一 个 有 如 下 两 种 接口 : 


(1、FormatterRegistry : 格式 化 转换 器 注册 器 ， 用 于 注册 格式 化 转换 器 (Formatter、Printer 
和 Parser、AnnotationFormatterFactory) ; 


package org.springframework.format; 
public interface FormatterRegistry extends ConverterRegistry { 
//Q 中 添加 格式 化 转换 器 (Spring3.1 新 增 API) 
void addFormatter(Formatter<?> formatter); 
/VC 为 指定 的 字段 类 型 添加 格式 化 转换 器 
void addFormatterForFieldType(Class<?> fieldType, Formatter<?> formatter ) ， 
//G@) 为 指定 的 字段 类 型 添加 Printer 和 Parser 
void addFormatterForFieldType(Class<?> fieldType, Printer<?> printer, Parser<?> parse 
// 包 添加 注解 驱动 的 字段 格式 化 工厂 AnnotationFormatterFactory 
void addFormatterForFieldAnnotation( 
AnnotationFormatterFactory<? extends Annotation> annotationFormatterFacto 





(2、FormattingConversionService : 继承 自 ConversionService， 运 行 时 类 型 转换 和 格式 
化 服务 接口 ， 提 供 运行 期 类 型 转换 和 格式 化 的 支持 。 


FormattingConversionService 内 部 实现 如 下 图 所 示 : 


Printer 


PrinterConverter Formatter 
Parser 


, , Par serConverter 
Formatt ingConver sionService 


convert () 方 法 


Annotat ionPr interConverter 


8 AnnotationFormatterFactory 
Annotat ionPar ser Gonver ter 


我 们 可 以 看 到 FormattingConversionService 内 部 实现 如 上 所 示 ， 当 你 调用 convert 方 法 时 : 
是 S 类 型 ----->String : 调用 私有 的 静态 内 部 类 PrinterConverter， 其 又 调用 相应 的 Printer 的 
实现 进行 格式 化 ; 


(2) 若 是 String----->T 类 型 : 调用 私有 的 静态 内 部 类 ParserConverter， 其 又 调用 相应 的 Parser 的 


(3) 若 是 A 注解 类 型 注解 的 S 类 型 ----->String : 调用 私有 的 静态 内 部 类 
AnnotationPrinterConverter， 其 又 调用 相应 的 AnnotationFormatterFactory 的 getPrinter 获 取 
Printer 的 实现 进行 格式 化 ; 


(若是 String----->A 注 解 类 型 注解 的 T 类 型 : 调用 私有 的 静态 内 部 类 
AnnotationParserConverter， 其 又 调用 相应 的 AnnotationFormatterFactory 的 getParser 获 取 
Parser 的 实现 进行 解析 。 


注 : S 类 型 表示 源 类 型 ，T 类 型 表示 目标 类 型 ，A 表 示 注 解 类 型 。 


此 处 可 以 可 以 看 出 之 前 的 Converter SPI 完 成 任意 Object 与 Object 之 间 的 类 型 转换 ， 而 
Formatter SPI 完 成 任意 Object 与 String 之 问 的 类 型 转换 〈 即 格式 化 和 解析 ， 与 PropertyEditor 
类 似 ) 。 


7.3.2、Spring 内 建 的 格式 化 转换 器 如 下 所 示 : 


类 名 说 明 
DateFormatter 9 实现 日 期 
NumberFormatter J J ， 实现 
CurrencyFormatter ， 0 be! pe 
PercentFormatter java.lang.Number<---->String 实 现 


百分数 样式 的 格式 化 /解析 


@NumberFormat 注 解 类 型 的 数字 

字段 类 型 <---->String@ 通 过 

@NumberFormat 指 定格 式 化 /解析 
NumberFormatAnnotationFormatterFactory 格式 加 可 以 格式 化 /解析 的 数字 类 

型 : Short、|nteger、Long、 

Float 、 Double、BigDecimal、 

Biglnteger 


@DateTimeFormat 注 解 类 型 的 日 
期 字段 类 型 <---->String@ 通 过 
@DateTimeFormat 指 定格 式 化 / 解 
析 格 式 加 可 以 格式 化 /解析 的 日 期 类 
型 : joda 中 的 日 期 类 型 

(org.joda.time 包 中 的 ) 
LocalDate 、LocalDateTime、 
LocalTime 、 Readablelnstantjava 
内 置 的 日 期 类 型 : Date、 
Calendar、Longclasspath 中 必须 
有 Joda-Time 类 库 ， 否 则 无 法 格式 
化 日 期 类 型 


JodaDateTimeFormatAnnotationFormatterFactory 


NumberFormatAnnotationFormatterFactory 和 
JodaDateTimeFormatAnnotationFormatterFactory (如 果 classpath 提 供 了 Joda-Time 类 库 ) 
在 使 用 格式 化 服务 实现 DefaultFormattingConversionService 时 会 自动 注册 。 


7.3.3、 示 例 


在 示例 之 前 ， 我 们 需要 到 http://joda-time.sourceforge.net/ 下 载 Joda-Time 类 库 ， 本 书 使 用 的 是 
joda-time-2.1 版 本 ， 将 如 下 jar 包 添加 到 classpath : 


joda-time-2.1.jar 


7.3.3.1、 类 型 级 别 的 解析 /格式 化 


一 、 直 接 使 用 Formatter SPI 进 行 解析 /格式 化 


// 二 、CurrencyFormatter : 实现 货币 样式 的 格式 化 /解析 

CurrencyFormatter currencyFormatter = new CurrencyFormatter(); 
currencyFormatter.setFractionDigits(2);// 保 留 小 数 点 后 几 位 
currencyFormatter.setRoundingMode(RoundingMode .CEILING);// 全 入 模式 (ceilling 表 示 四 使 五 入 ) 


//1、 将 带 货币 符号 的 字符 串 “$123.125” 转 换 为 BigDecimal("123.00") 

Assert.assertEquals(new BigDecimal("123.13"), currencyFormatter.parse("$123.125", Locale. 
//2、 将 BigDecimal("123") 格 式 化 为 字符 串 “$123.00” 展 示 

Assert.assertEquals("$123.00", currencyFormatter.print(new BigDecimal("123"), Locale.US)) 
Assert.assertEquals(" 芋 123.00", currencyFormatter.print(new BigDecimal("123"), Locale.CcHIl 
Assert.assertEquals(" 芋 123.00", currencyFormatter.print(new BigDecimal("123"), Locale.JAP, 


4] el 








parse 方 法 : 将 带 格式 的 字符 串 根 据 Locale 信 息 解 析 为 相应 的 BigDecimal 类 型 数据 ; 
print 方 法 : 将 BigDecimal 类 型 数据 根据 Locale 信 息 格 式 化 为 字符 串 数 据 进行 展示 。 
不 同 于 Convert SPI，Formatter SPI 可 以 根据 本 地 化 (Locale) 信息 进行 解析 /格式 化 。 


其 他 测试 用 例 请 参考 cn.javass.chapter7.web.controller.support.formatter.InnerFormatterTest 
的 testNumber 测 试 方法 和 testDate 测 试 方法 。 


二 、 使 用 DefaultFormattingConversionService 进 行 解析 /格式 化 


@Test 

public void testwithDefaultFormattingConversionService() { 
DefaultFormattingConversionService conversionService = new DefaultFormattingConversio 
// 默 认 不 自动 注册 任何 Formatter 
CurrencyFormatter currencyFormatter = new CurrencyFormatter(); 
currencyFormatter .setFractionDigits(2);// 保 留 小 数 点 后 几 位 
currencyFormatter .setRoundingMode(RoundingMode .CEILING) ;// 仿 入 模式 《cei1l1ing 表 示 四 伟 五 入 ， 
// 注 册 Formatter SPI 实 现 
conversionService.addFormatter(currencyFormatter ) 


// 绑 定 Locale 信 息 到 ThreadLocal 

//FormattingConversionService 内 部 自动 获取 作为 Locale 人 信息， 如 果 不 设 值 默认 是 Locale .getDefault 
LocaleContextHolder.setLocale(Locale.US); 

Assert.assertEquals("$1,234.13", conversionService.convert(new BigDecimal("1234.128") 
LocaleContextHolder.setLocale(null); 


LocaleContextHolder.setLocale(Locale.CcCHINA); 
Assert.assertEquals("¥1,234.13", conversionService.convert(new BigDecimal("1234.: 


Assert.assertEquals(new BigDecimal("1234.13"), conversionService.convert("¥1,234.13" 
LocaleContextHolder.setLocale(null);} 


Le 王立 一 一 ; 


DefaultFormattingConversionService : 带 数 据 格式 化 功能 的 类 型 转换 服务 实现 ; 





conversionService.addFormatter() : 注册 Formatter SPI 实 现 ; 


ee IE BigDecimal("1234.128"), String.class) : 用 于 将 BigDecimal 
类 型 数据 格式 化 为 字符 串 类 型 ， 此 处 根据 “LocaleContextHolder.setLocale(locale)" 设 置 的 本 地 
化 信息 进行 格式 化 ; 


AAS EAIGLLOA 全 234.13", BigDecimal.class) : 用 于 将 字符 串 类 型 数据 解析 为 
BigDecimal 类 型 数据 ， 此 处 也 是 根据 “LocaleContextHolder.setLocale(locale)" 设 置 的 本 地 化 信 
息 进行 解 ; 


LocaleContextHolder.setLocale(locale) : 设置 本 地 化 信息 到 ThreadLocal， 以 便 Formatter SPI 
根据 本 地 化 信息 进行 解析 /格式 化 ; 


具体 测试 代码 请 参考 cn.javass.chapter7.web.controller.support.formatter.InnerFormatterTest 
的 testWithDefaultFormattingConversionService 测 试 方法 。 


三 、 自 定义 Formatter 进 行 解析 /格式 化 
此 处 以 解析 /格式 化 PhoneNumberModel| 为 例 。 


(1、 定 义 Formatter SPI 实 现 


package cn.javass,chapter7.web.controller,.Ssupport .formatter ; 
// 省 略 import 
public class PhoneNumberFormatter implements Formatter<PhoneNumberModel> { 
Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); 
Q@Override 
public String print(PhoneNumberModel phoneNumber, Locale locale) {//QD 格 式 化 
if(phoneNumber == null) { 
return ™"; 
} 


return new StringBuilder().append(phoneNumber .getAreaCode()).append("-") 


.append(phoneNumber .getPhoneNumber()).toSstring(); 
} 


Q@Override 
public PhoneNumberModel parse(String text, Locale locale) throws ParseException {//®. 
if(!StringUtils.hasLength(text)) { 
//(D 如 果 source 为 空 返回 null 
return null; 
} 
Matcher matcher = pattern.matcher(text); 
if(matcher.matches()) { 
// 避 如 果 匹 配 进行 转换 
PhoneNumberModel phoneNumber = new PhoneNumberModel(); 
phoneNumber .setAreaCode(matcher .group(1)); 
phoneNumber .setPhoneNumber(matcher .group(2)); 
return phoneNumber; 
} else { 
/V/G@ 如 果 不 匹 配 转换 失败 


throw new IllegalArgumentException(String.format(" 类 型 转换 失败 ， 需 要 格式 [010-123< 





类 似 于 Convert SPI 实 现 ， 只 是 此 处 的 相应 方法 会 传 入 Locale 本 地 化 信息 ， 这 样 可 以 为 不 同 地 
区 进行 解析 /格式 化 数据 。 


(2、 测 试用 例 : 


package cn.javass,chapter7.web.controller.Ssupport ,formatter ; 
// 省 略 import 
public class CustomerFormatterTest { 
@Test 
public void test() { 
DefaultFormattingConversionService conversionService = new DefaultFormattingConve 
conversionService.addFormatter(new PhoneNumberFormatter()); 


PhoneNumberModel phoneNumber = new PhoneNumberModel("010", "12345678"); 
Assert.assertEquals("010-12345678", conversionService.convert(phoneNumber, String 


Assert.assertEquals("010", conversionService.convert("010-12345678", PhoneNumberM 








通过 PhoneNumberFormatter 可 以 解析 String--->PhoneNumberModel 和 格式 化 
PhoneNumberModel--->String。 


到 此 ， 类 型 级 别 的 解析 /格式 化 我 们 就 介绍 完了 ， 从 测试 用 例 可 以 看 出 类 型 级 别 的 是 对 项 目 中 
的 整个 类 型 实施 相同 的 解析 /格式 化 逻辑 。 


有 的 同学 可 能 需要 在 不 同 的 类 的 字段 实施 不 同 的 解析 /格式 化 逻辑 ， 如 用 户 模型 类 的 注册 日 期 
字段 只 需要 如 *2012-05-02" 格 式 进 行 解析 /格式 化 即 可 » 而 订单 模型 类 的 下 订单 日 期 字段 可 能 
需要 如 “2012-05-02 20 : 13 : 13” 格 式 进行 展示 。 


接 下 来 我 们 学 习 一 下 如 何 进 行 字 段 级 别 的 解析 /格式 化 吧 。 


7.3.3.2、 字 段 级 别 的 解析 /格式 化 
一 、 使 用 内 置 的 注解 进行 字段 级 别 的 解析 /格式 化 : 


(1、 测 试 模型 类 准备 : 


package cn.javass.chapter7.model; 

public class FormatterModel { 
@NumberFormat(style=Style.NUMBER, pattern="#,###") 
private int totalCount; 
@NumberFormat(style=Style.PERCENT) 
private double discount; 
@NumberFormat(style=Style .CURRENCY) 
private double sumMoney; 


@DateTimeFormat (iso=ISO .DATE) 
private Date registerDate; 


@DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss") 
private Date orderDate; 


// 省 略 getter/setter 


此 处 我 们 使 用 了 Spring 字段 级 别 解析 /格式 化 的 两 个 内 置 注 解 : 


@Number : 定义 数字 相关 的 解析 /格式 化 元 数据 (通用 样式 、 货 币 样式 、 百 分 数 样式 ) ， 参 数 
如 下 : 


style : 用 于 指定 样式 类 型 ， 包 括 三 种 : Style.NUMBER (通用 样式 ) Style.CURRENCY ( 货 
币 样 式 ) Style.PERCENT (百分数 样式 ) ， 默 认 Style.NUMBER ; 


pattern : 自 定义 样式 ， 如 patter="#,###" ; 
@DateTimeFormat : 定义 日 期 相关 的 解析 /格式 化 元 数据 ， 参 数 如 下 : 
pattern : 指定 解析 /格式 化 字段 数据 的 模式 ， 如 ”yyyy-MM-dd HH:mm:ss” 


iso : 指定 解析 /格式 化 字段 数据 的 ISO 模式 ， 包 括 四 种 : ISO.NONE (不 使 用 ) 
ISO.DATE(yyyy-MM-dd) ISO.TIME(hh:mm:ss.SSSZ) ISO.DATE_ TIME(yyyy-MM-dd 
hh:mm:ss.SSSZ)， 上 默认 ISO.NONE ; 


style : 指定 用 于 格式 化 的 样式 模式 ， 默 认 “SS”， 上 有 具体 使 用 请 参考 Joda-Time 类 库 的 
org.joda.time.format.DateTimeFormat 的 forStyle 的 javadoc ; 


优先 级 : pattern 大 于 iso 大 于 style。 


(2、 测 试用 例 : 


@Test 
public void test() throws SecurityException, NoSuchFieldException { 
// 默 认 自动 注册 对 @NumberFormat 和 @DateTimeFormat 的 支持 
DefaultFormattingConversionService conversionService = 
new DefaultFormattingConversionService(); 


// 准 备 测试 模型 对 象 

FormatterModel model = new FormatterModel(); 
model.setTotalCount (10000); 

model.setDiscount(0.51); 

model.setSumMoney(10000.13); 

model.setRegisterDate(new Date(2012-1900, 4, 1)); 
model.setorderDate(new Date(2012-1900, 4, 1, 20, 18, 18)); 


// 获 取 类 型 信息 
TypeDescriptor descriptor = 


new TypeDescriptor(FormatterModel.class.getDeclaredField("totalCcount")); 
TypeDescriptor stringDescriptor = TypeDescriptor.valueof(String.class); 


Assert.assertEquals("10,000", conversionService.convert(model.getTotalCount(), descri 
Assert.assertEquals(model.getTotalCount(), conversionService.convert("10,000", string 


-| 


TypeDescriptor : 拥有 类 型 信息 的 上 下 文 ， 用 于 Spring3 类 型 转换 系统 获取 类 型 信息 的 (可 以 
包含 类 、 字 段 、 方 法 参数 、 属 性 信息 ) ; 通过 TypeDescriptor， 我 们 就 可 以 获取 (类 、 字 段 、 
方法 参数 、 属 性 ) 的 各 种 信息 ， 如 注解 类 型 信息 ; 





conversionService.convert(model.getTotalCount(), descriptor, stringDescriptor) : 将 
totalCount 格 式 化 为 字符 串 类 型 ， 此 处 会 根据 totalCount 字 段 的 注解 信息 (通过 descriptor 对 象 
获取 ) 来 进行 格式 化 ; 


conversionService.convert("10,000", stringDescriptor, RN : 将 字符 串 “10,000” 解 析 为 
totalCount 字 段 类 型 ， 此 处 会 根据 totalCount 字 段 的 注解 信息 (通过 descriptor 对 象 获 取 ) 来 进 
行 解析 。 


(3、 通 过 为 不 同 的 字段 指定 不 同 的 注解 信息 进行 字段 级 别 的 细 粒 度数 据 解析 /格式 化 


descriptor = new TypeDescriptor(FormatterModel.class.getDeclaredField("registerDate")); 
Assert.assertEquals("2012-05-01", conversionService.convert(model.getRegisterDate(), desc 
Assert.assertEquals(model.getRegisterDate(), conversionService.convert("2012-05-01", stri 


descriptor = new TypeDescriptor(FormatterModel.class.getDeclaredField("orderDate")); 
Assert.assertEquals("2012-05-01 20:18:18", conversionService.convert(model.getOrderDate() 
Assert.assertEquals(model.getOorderDate(), conversionService.convert("2012-05-01 20:18:18" 


凤 本 二 


通过 如 上 测试 可 以 看 出 ， 我 们 可 以 通过 字段 注解 方式 实现 细 粒 度 的 数据 解析 /格式 化 控制 ， 但 
en 息 ， 即 编程 实现 字段 的 数据 解析 /格式 化 比 
较 麻 烦 。 





其 他 测试 用 例 请 参考 
cn.javass.chapter7.web.controller.support.formatter.InnerFieldFormatterTest 的 test 测 试 方 
法 。 


二 、 自 定义 注解 进行 字段 级 别 的 解析 /格式 化 : 
此 处 以 解析 /格式 化 PhoneNumberModel 字 段 为 例 。 


(1、 定 义 解 析 / 格 式 化 字段 的 注解 类 型 : 


package cn.javass,chapter7.web.controller.Ssupport ,formatter ; 

// 省 略 import 

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 

public @interface PhoneNumber { 


} 


(2、 实 现 AnnotationFormatterFactory 注 解 格 式 化 工厂 : 


package cn.javass,chapter7.web.controller,.Ssupport ,formatter ; 
// 省 略 import 
public class PhoneNumberFormatAnnotationFormatterFactory 


implements AnnotationFormatterFactory<PhoneNumber> {//Q 指 定 可 以 解析 /格式 化 的 字段 注解 类 型 


private final Set<Class<?>> fieldTypes; 
private final PhoneNumberFormatter formatter; 
public PhoneNumberFormatAnnotationFormatterFactory() { 
Set<Class<?>> set = new HashSet<Class<?>>(); 
set.add(PhoneNumberModel .class); 
this.fieldTypes = set; 
this.formatter = new PhoneNumberFormatter();// 此 处 使 用 之 前 定义 的 Formatter 实 现 


} 

/VCG) 指 定 可 以 被 解析 /格式 化 的 字段 类 型 集合 

Q@override 

public Set<Class<?>> getFieldTypes() { 
return fieldTypes; 

} 

//( 加 根据 注解 信息 和 字段 类 型 获取 解析 器 

Q@Override 

public Parser<?> getParser(PhoneNumber annotation, Class<?> fieldType) { 
return formatter; 


} 

// 四 根据 注解 信息 和 字段 类 型 获取 格式 化 器 

Q@override 

public Printer<?> getPrinter(PhoneNumber annotation, Class<?> fieldType) { 
return formatter; 


} 
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AnnotationFormatterFactory 实 现 会 根据 注解 信息 和 字段 类 型 获取 相应 的 解析 器 /格式 化 器 。 


(3、 修 改 FormatterModel 添 加 如 下 代码 : 


@PhoneNumber 


private PhoneNumberModel phoneNumber ; 


(4、 测 试用 例 


@Test 


public void test() throws SecurityException, NoSuchFieldException { 


DefaultFormattingConversionService conversionService = 
new DefaultFormattingConversionService();// 创 建 格 2 
conversionService.addFormatterForFieldAnnotation( 
new PhoneNumberFormatAnnotationFormatterFactory());// 添 加 自 定义 的 注解 格 z 


FormatterModel model = new FormatterModel(); 
TypeDescriptor descriptor = 

new TypeDescriptor(FormatterModel.class.getDeclaredField("phoneNumber")); 
TypeDescriptor stringDescriptor = TypeDescriptor.valueof(String.class); 


PhoneNumberModel value = (PhoneNumberModel) conversionService.convert("010-12345678", 
model.setPhoneNumber (value); 


Assert.assertEquals("010-12345678", conversionService.convert(model.getPhoneNumber(), 
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此 处 使 用 DefaultFormattingConversionService 的 addFormatterForFieldAnnotation 注 册 自 定义 
的 注解 格式 化 工厂 PhoneNumberFormatAnnotationFormatterFactory。 


集成 到 Spring Web MVC 环 境 中 。 


7.3.4、 集 成 到 Spring Web MVC 环 境 
一 、 注 册 FormattingConversionService 实 现 和 自 定义 格式 化 转换 器 : 


<bean id="conversionService" 
class="org.springframework.format.support.FormattingConversionServiceFactoryBean"> 
<! 一 此 处 省 略 之 前 注册 的 自 定义 类 型 转换 器 - -> 
<property name="formatters"> 
<list> 
<bean class="cn.javass.chapter7 .web.controller.support.formatter. 
PhoneNumberFormatAnnotat 
</list> 
</property> 
</bean> 
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其 他 配置 和 之 前 学 习 7.2.2.4 一 节 一 样 。 
二 、 示 例 : 


(1、 模 型 对 象 字段 的 数据 解析 /格式 化 : 


@RequestMapping(value = "/format1") 

public String test1(@ModelAttribute("model") FormatterModel formatModel) { 
return "format/success"; 

} 


totalCount:<spring:bind path="model.totalCount">${status.value}</spring:bind><br/> 
discount:<spring:bind path="model.discount">${status.value}</spring:bind><br/> 
sumMoney:<spring:bind path="model.sumMoney">${status.value}</spring:bind><br/> 
phoneNumber:<spring:bind path="model.phoneNumber">${status.value}</spring:bind><br/> 

<1-- 如 果 没 有 配置 org .springframework.web.servlet.handler.ConversionServiceExposingIntercept 
phoneNumber:<spring:eval expression="model.phoneNumber"></spring:eval><br/> 


<br/><br/> 

<form:form commandName="model"> 
<form:input path="phoneNumber"/><br/> 
<form:input path="sumMoney"/> 

</form:form> 


IE 





在 浏览 器 输入 测试 URL : 


http://localhost:9080/springmvc-chapter7/format1? 
totalCount=100000&discount=0.51&sumMoney=100000.128&phoneNumber=010-12345678 


数据 会 正确 绑 定 到 我 们 的 formatModel， 即 请 求 参 数 能 被 正确 的 解析 并 绑 定 到 我 们 的 命令 对 象 
上 ， 而 且 在 JSP 页 面 也 能 正确 的 显示 格式 化 后 的 数据 〈 即 正确 的 被 格式 化 显示 ) 。 


《2、 功 能 处 理 方 法 参数 级 别 的 数据 解析 : 


@RequestMapping(value = "/format2") 

public String test2( 
@PhoneNumber @RequestParam("phoneNumber") PhoneNumberModel phoneNumber, 
@DateTimeFormat(pattern="yyyy-MM-dd") @RequestParam("date") Date date) { 
System.out.println(phoneNumber); 
System.out.println(date); 
return "format/success2"，; 


此 处 我 们 可 以 直接 在 功能 处 理 方法 的 参数 上 使 用 格式 化 注解 类 型 进行 注解 ，Spring Web MVC 
能 根据 此 注解 信息 对 请 求 参数 进行 解析 并 正确 的 绑 定 。 


在 浏览 器 输入 测试 URL : 


http://localhost:9080/springmvc-chapter7/format2?phoneNumber=010- 
12345678&date=2012-05-01 


数据 会 正确 的 绑 定 到 我 们 的 phoneNumber 和 date 上 ， 即 请 求 的 参数 能 被 正确 的 解析 并 绑 定 到 
我 们 的 参数 上 。 


控制 器 代码 位 于 cn.javass.chapter7.web.controller.DataFormatTestController 中 。 


如 果 我 们 请 求 参 数 数据 不 能 被 正确 解析 并 绑 定 或 输入 的 数据 不 合法 等 该 怎么 处 理 呢 ? 接 下 来 
的 一 节 我 们 来 学 习 下 绑 定 失败 处 理 和 数据 验证 相关 知识 。 





第 一 章 Web MVC 简 介 跟 开 涛 学 SpringMVC 
Web MVC 简 介 


1.1、Web 开 发 中 的 请 求 -响应 模型 : 


1、 请 求 

http ://sishuok. co 
Web 客 一 端 一 一 一 一 一 Web 服 务 器 
如 Web 浏 览 器 正 2、 响 应 1、 接 收 请 求 


1、 发 送 请 求 rp 2 、 处 理 请 求 
>、 接收 响应 并 演 染 | < 下 电 半 所 页 内 容 3、 产 生 响应 


在 Web 世 界 里 ， 具 体 步 骤 如 下 : 





1、 Web 浏 览 器 (如 |E) 发 起 请 求 ， 如 访问 http://sishuok.com 


2、Web 服 务 器 (如 Tomcat) 接收 请 求 ， 处 理 请 求 (比如 用 户 新 增 ， 则 将 把 用 户 保存 一 
下 ) ， 最 后 产生 响应 (一 般 为 html) 。 


3、web 服 务 器 处 理 完成 后 ， 返 回 内 容 给 web 客 户 端 (一 般 就 是 我 们 的 浏览 器 ) ， 客 户 端 对 接 
收 的 内 容 进行 处 理 (如 Web 浏览 器 将 会 对 接收 到 的 html 内 容 进 行 泻 染 以 展示 给 客户 ) 。 
因此 ， 在 Web 世 界 里 : 

都 是 Web 客 户 端 发 起 请 求 ，VWeb 服 务 器 接收 、 处 理 并 产生 响应 。 


一 般 Web 服 务 器 是 不 能 主动 通知 Web 客 户 端 更 新 内 容 。 虽 然 现 在 有 些 技术 如 服务 器 推 (如 
Comet) 、 还 有 现在 的 HTML5 websocket 可 以 实现 Web 服 务 器 主动 通知 Web 客 户 端 


到 此 我 们 了 解 了 在 Web 开 发 时 的 请 求 /响应 模型 ， 接 下 来 我 们 看 一 下 标准 的 MVC 模 型 是 什么 
1.2、 标 准 MVC 模 型 概述 


MVC 模 型 : 是 一 种 架构 型 的 模式 ， 本 身 不 引入 新 功能 ， 只 是 帮助 我 们 将 开发 的 结构 组 织 的 更 
加 合理 ， 使 展示 与 模型 分 离 、 流 程控 制 逻辑 、 业 务 逻 辑 调用 与 展示 逻辑 分 离 。 如 图 1-2 


控制 器 2、 状 态 改 变 ， 可 能 返回 
接收 用 卢 清 打 一 ”视图 要 展示 的 模型 数据 


要 托 为 核 型 谍 行 外 外 





交 发 送 请 求 选 芭 设 图 【并 柜 态 型 返回 的 萄 其 丛 设 加 
了 模型 
流 -| 状 老 长 变 【一般 视 是 业务 刘 秃 
3、 选 择 视图 ， 展 示 模型 oe 





二 Ar 
4、 返 回响 应 





3、 将 模型 站 牧 推 给 
视图 “视图 〈 推 模型 


压 示 核 型 区 所 
提 典 人 机 实 互 寞 加 用 干 坊 能 哨 茶 答 





图 1-2 
首先 让 我 们 了 解 下 MVC (Model-View-Controller) 三 元 组 的 概念 : 


Model (模型 ) : 数据 模型 ， 提 供 要 展示 的 数据 ， 因 此 包含 数据 和 行为 ， 可 以 认为 是 领域 模型 
或 JavaBean 组 件 (包含 数据 和 行为 )， 不 过 现在 一 般 都 分 离开 来 : Value Object (数据 ) 和 
服务 层 (行为 )。 也 就 是 模型 提供 了 模型 数据 查询 和 模型 数据 的 状态 更 新 等 功能 ， 包 括 数据 
和 业务 。 

View (视图 ) : 负责 进行 模型 的 展示 ， 一 般 就 是 我 们 见 到 的 用 户 界 面 ， 客户 想 看 到 的 东西 。 
Controller (控制 器 ) : 接收 用 户 请 求 ， 委 托 给 模型 进行 处 理 (状态 改变 ) ， 处 理 完 毕 后 把 返 
回 的 模型 数据 返回 给 视图 ， 由 视图 负责 展示 。 也 就 是 说 控制 器 做 了 个 调度 员 的 工作 ，。 

从 图 1-1 我 们 还 看 到 ， 在 标准 的 MVC 中 模型 能 主动 推 数 据 给 视图 进行 更 新 (观察 者 设计 模式 ， 
在 模型 上 注册 视图 ， 当 模型 更 新 时 自动 更 新 视图 ) ， 但 在 Web 开 发 中 模型 是 无 法 主动 推 给 视 
图 (无 法 主动 更 新 用 户 界 面 ) ， 因 为 在 Web 开 发 是 请 求 -响应 模型 。 


那 接 下 来 我 们 看 一 下 在 Web 里 MVC 是 什么 样子 ， 我 们 称 其 为 Web MVC 来 区 别 标准 的 MVC 。 


1.3、Web MVC 概 述 


模型 -视图 -控制 器 概念 和 标准 MVC 概 念 一 样 ， 请 参考 1.2， 我 们 再 看 一 下 Web MVC 标 准 架构 ， 
如 图 1-3 : 


控制 器 2、 状 态 改 变 ， 可 能 返回 


_ 末 楼 愧 用 户 消 久 一 ”视图 要 展示 的 模型 数据 
| 受托 为 核 型 谎 行 处 再 PR 


| 刘 发 送 请 求 选 瓜 说 图 【并 把 核 型 返回 的 秽 换 谷 设 加 


pe 3、 选 择 视图 ， 展 示 模 型 


用 户 、_ 
4、 返 回响 应 


模型 


状 老 改变 【一 释 禹 旦 业务 远 知 
保存 数据 





视图 


压 示 核 型 区 所 
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如 图 1-3 


在 Web MVC 模 式 下 ， 模 型 无 法 主动 推 数 据 给 视图 ， 如 果 用 户 想 要 视图 更 新 ， 需 要 再 发 送 一 次 
请 求 ( 即 请 求 -响应 模型 ) 。 


概念 差不多 了 ， 我 们 接 下 来 了 解 下 Web 端 开发 的 发 展 历程 ， 和 使 用 代码 来 演示 一 下 Web MVC 
是 如 何 实现 的 ， 还 有 为 什么 要 使 用 MVC 这 个 模式 呢 ? 


1.4、Web 端 开发 发 展 历程 


此 处 我 们 只 是 简单 的 叙述 比较 核心 的 历程 ， 如 图 1-4 
Ts Model (Web MVC) 
| 
| | 


Front Controller 
十 


Modell 





Page Controller 


图 1-4 


1.4.1、CGI : (Common Gateway Interface) 公共 网 关 接 口 ， 一 种 在 Web 服 务 端 使 用 的 脚本 
技术 ， 使 用 C 或 Perl 语 言 编写 ， 用 于 接收 Web 用 户 请 求 并 处 理 ， 最 后 动态 产生 响应 给 用 户 ， 但 
每 次 请 求 将 产生 一 个 进程 ， 重 量 级 。 


1.4.2、Servlet : 一 种 JavaEE web 组 件 技术 ， 是 一 种 在 服务 器 端 执行 的 web 组 件 ， 用 于 接收 
Web 用 户 请 求 并 处 理 ， 最 后 动态 产生 响应 给 用 户 。 但 每 次 请 求 只 产生 一 个 线程 (而 且 有 线程 
池 ) ， 轻 量 级 。 而 且 能 利用 许多 JavaEE 技 术 (如 JDBC 等 )。 本 质 就 是 在 里 面 输出 html 流 。 
但 表现 逻辑 、 控 制 逻辑 、 业 务 逻 辑 调 用 混杂 。 如 图 1-5 


Public class LoyginServlet extends HttpServlet { 

BOverride 

protected void doGet IHttpServlethRequest red, HtpServletResponse resp) 

throws ServletExcepticon, IDException { 

doPost (red respb)zyy 为 了 简单 ， 直 苇 委 发 答 doPost 进行 处 焊 

} 

BOwverride 

Pprotected void doPost!HttpServlet Request red, HttpServlethResponse resp) 
throws ServletExcepticon, IOException { 


String submitFlag = redq. getParameter ("submitFlag"); 

ifi"toLogin".equalsisubmitFlag)) { Bb 请 求 
toLoyginiredq, resp);return; 1、 控 制 罗 辑 : 根据 R 参 

} else ifi"login".equalsisubmitFlag)) 1{ 数 选 择 要 执行 的 功能 方法 
loyginired, resp);retuwn; 


} 
toLogin tireq，resp); // 跌 让 到 登录 页 面 

} 

Pprivate void toLogin'iHttpServlethRequest redyq, HtpServletResponse resp) 
throws IOExcepticon { 
resp.setContentType ltext /html"); 
String loginPath = req.getCortextPathi) + "/servletLogin"; 
PrintWriter write = resp. getWriter'); 


wite.writet"<form action='" + loginPath + "' method='post'>"); = 
wite.writet"<inptt type='text' name='submitFlayg' value='login'/>") 2、 表现 代码 : 页 面 展示 直 
wite.writet"'username: <input 了 7Pe= ' 汪 E 北 Dame='UsSename ' />"); 搁 放 在 我 们 的 serv et 里边 


wite.witet"password: <input type='password' name='password'/>"); 
wite.writet"<inpuw type='submit’' value='login'/>"); 
wite.writet"</form>"); 

} 

private void loyginiHttpServlet Request redq, HttpServlethResponse resp) 
throws IOExcepticn 1{ 
/ff1 收 朱 若 娄 
Strinyg username = red. getParameter ("username"); 
Strinyg password = red. getParameter ("password"); 


f/fZ 验 证 并 对 装 若 数 1 生息 的 步 束 ) 


UserBeam user = new UserBean!); 3、 调用 业务 对 象 (javahean 对 象 ) 进 
user.setUsermame (username); 

user.setPhasswordipassword); 行 登录 : 即 模型 ， 不 仅 包 含 数据 还 
/773 阅 用 jatrabesan 和 对象 《业务 方法 ) 包含 行为 


ifiuser.logint)) { 
f/f4 根 据 返 回 位 选 俊 下 一 个 页 面 
resp.getWritert).writet"login success"); 
} else 1{ 
resp.getWritert).writet"login fail"); 


} 
L 


} 
图 1-5 


如 图 1-5， 这 种 做 法 是 绝对 不 可 取 的 ， 控 制 座 辑 、 表 现代 码 、 业 务 逻 辑 对 象 调用 混杂 在 一 起 ， 
最 大 的 问题 是 直接 在 里 面 输出 Html， 这 样 前 端 开 发 人 员 无 法 进行 页 面 风格 等 的 设计 与 修改 ， 
即使 修改 也 是 很 麻烦 ， 因 此 实际 项 目 这 种 做 法 不 可 取 。 


1.4.3、JSP : (Java Server Page) :一 种 在 服务 器 端 执行 的 web 组 件 ， 是 一 种 运行 在 标准 的 
HTML 页 面 中 吝 入 脚本 语言 (现在 只 支持 Java) 的 模板 页 面 技术 。 本 质 就 是 在 html 代 码 中 诅 
入 。JSP 最 终 还 是 会 被 编译 为 Servlet， 只 不 过 比 纯 Servlet 开 发 页 面 更 简单 、 方 便 。 但 表现 逻 
辑 、 控 制 人 逻辑、 业务 逻辑 调用 还 是 混杂 。 如 图 1-6 


<$Bpage iport= "on.7avass.chapteri. javabean .UserBeam'"s> 
<$0 page lamnguage= "javea" cortentType= "text/htnl; charset=UTF-8" 
paygeEncoding="UTF-8"+> 


<IDOCTYPE ktml PUBLIC "-//W3C//DTID HINML 4.01 Tramsitional//EN" "http: ywW3-orgrTRIhtm1471oose- dd"> 
<html> 
<head> 
*meta http-equiv="Comtent-Type" content= "texwt/htnml; charset=UTF-8"> 
<title> 合 好 </title> 
</head> 
<body> 
String submitFlag = request .yetParameter ("submitFlag"); 
ifi"login".equalstisubmitFlag)) {// 登 录 入 1、 控 制 i 罗 辑 : 根据 请 求 参 


String username redquest. yet Parameter ("username"); 

String password redquest. getParameter ("password"); 

A/Z 验 证 开封 装 苔 数 

UserBean user = new UserBean(); 性 调用 业务 对 象 javahean 对 象 ) 进 


人 罗 江 $ 数 选 择 要 执行 的 功能 方法 


user .setUsername (username}; 行 登录 ， 即 模型 ， 不 仅 包 含 数 据 还 
和 要 


user .setPassword'lpassword); 
/733 阅 用 javabean 对 象 【 业 务 方法 》 包含 行为 
ifiuser.logint)) 1{ 
/#74 根据 返回 位 选 保 下 一 个 页 面 
ou .writet"loygin success"); 
} else { 
or .witet"loygin fail") 7 


} 
} else 1{ 
条 > 
<form action="" Inethoad= "Dos "> 
<input type= "hididen" name= "submitFlacg" value=, 29g 孜 搞 代 码 s 页 面 展 示 直 
username: *input type= "text" name="username" >| i , 搁 放 在 我 们 的 serv et 里 边 
password: *input type= "passnord" name= "passworB"/><br/> 
<inpt type= "submit" value="logim"/> 
</ form> 
} 
</body> 
</html> 


图 1-6 


如 图 1-6， 这 种 做 法 也 是 绝对 不 可 取 的 ， 控 制 逻辑 、 表 现代 码 、 业 务 逻 辑 对 象 调用 混杂 在 一 
起 ， 但 比 直 接 在 servlet 里 输出 html 要 好 一 点 ， 前 端 开 发 人 员 可 以 进行 简单 的 页 面 风格 等 的 设计 
与 修改 (但 如 果 诅 入 的 java 脚 本 太 多 也 是 很 难 修改 的 ) ， 因 此 实际 项 目 这 种 做 法 不 可 取 。 


Nodel 


Javabean 
或 


votservice( 分 层 ) 





JSP 本 质 还 是 Servlet， 最 终 在 运行 时 会 生成 一 个 Servlet (如 tomcat， 将 在 
tomcat\work\Catalina\web 应 用 名 \org\apache\jsp 下 生成 ) ， 但 这 种 使 得 写 html 简 单 点 ， 但 仍 
是 控制 逻辑 、 表 现代 码 、 业 务 逻 辑 对 象 调用 混杂 在 一 起 。 


1.4.4、Model1 : 可 以 认为 是 JSP 的 增强 版 ， 可 以 认为 是 jsp+javabean 如 图 1-7 


特点 : 使 用 <jsp:useBean> 标 准 动作 ， 自 动 将 请 求 参数 封装 为 JavaBean 组 件 ; 还 必须 使 用 
java 脚 本 执行 控制 逻辑 。 
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<$Bpayge import="on.javass.chapteri. javabean .UserBesm'"s> 
和 Dar Rn II] 二 173W3 1 nn P 了 他 广 痪 > 3 > 


mtnt, Tme=" 





a 收集 参数 和 组 织 条 雪 


<jsp:useBean id= "zsemr” class="cm.javass.chapteri.javabean.UserBeanm'"/> 简单 了 许多 
<$--1、 收 集 戎 数 六 至 装 戎 数 〔 比 直接 使 用 了 jsp， 在 这 块 足 莘 单 的 》 一 名 > 


<*jsp:setProperty name="user" property="*"/> 





< 
String submitFlayg = request .ygetParasmeter ("submitFlayg"); 

(Login": equnls (subnity Lag)) :{/7 全 +t 1、 控 制 罗 辑 : 根据 请 求 参 

// 3 网 用 javabean 对 象 业务 方法 》 了 数 选 择 要 执行 的 功能 方法 


if tuser. logint)) 


{ 
/14 根据 返回 位 选 称 下 一 个 页 面 3、 调 用 业务 对 象 (jarahean 对 象 ) 进 


ou .writet"loygin success"); 行 登录 : 即 模型 ， 不 仅 包 念 堵 据 还 
es 包含 行为 
Di 让- 让 elLogin fail") 7 
} 
} else 1{ 
<form action="" method="post"> 


<*inpt type= "bidden" name= "submitFlag" valueY login"/> i 
2 入 霓 代 码 。 页 面 展示 直 
username: <input 上 ype= "text" name="zaserzaze"y> 1] 控 放 在 我 们 的 servlt 里 边 
password: <Input type= "passnord" name= "passwor"/><br/> 
<inpu type= "submit" value="logim"/> 
</ form> 

芭 多 } $> 

<*/body> 

</html> 


图 1-7 


此 处 我 们 可 以 看 出 ， 使 用 <jsp:useBean> 标 准 动作 可 以 简化 javabean 的 获取 /创建 ， 及 将 请 求 
参数 封装 到 javabean， 再 看 一 下 Model1 架 构 ， 如 图 1-8。 


JSP 
接收 用 户 请 求 
委托 为 javabean 进 行 处 理 


产生 响应 






raBean 组 件 执 


JavaBeal 


状态 改变 维护 ) 


图 1-8 Model1 架 构 


Model1 架 构 中 ，JSP 负 责 控 制 逻辑 、 表 现 逻 辑 、 业 务 对 象 (javabean) 的 调用 ， 只 是 比 纯 
JSP 简 化 了 获取 请 求 参数 和 封装 请 求 参数 。 同 样 是 不 好 的 ， 在 项 目 中 应 该 严禁 使 用 (或 最 多 再 
demo 里 使 用 ) 。 
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1.4.5、Model2 : 在 JavaEE 世 界 里 ， 它 可 以 认为 就 是 Web MVC 模 型 


Model2 架 构 其 实 可 以 认为 就 是 我 们 所 说 的 Web MVC 模 型 ， 只 是 控制 器 采用 Servlet、 模 型 采用 
JavaBean、 视 图 采用 JSP， 如 图 1-9 





控制 器 2、 状 态 改变 ， 可 能 返回 
Oe 一 ”视图 要 隧 示 的 模型 数据 


委 长 为 模 型 进行 处 理 
选 俊 视 国 ‘并 把 模型 返回 的 数据 答 视 苇 


™ 


模型 


JavaBean . 
状 套 改 灾 一般 就 足 业务 逻 揭 
塌 丰 数据 


芭 改 数 杨 
查询 数 杨 


视图 
JSP 


后 示 模 型 数据 
所 供 估 机 交互 界面 用 于 功能 请 求 等 


DB 
图 1-9 Model2 架 构 


具体 代码 事例 如 下 : 
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public class UserBean implements jJava.io.Serializable { 


private String username; 

private String password; 

public String getUsernamel() { 
return username; 

} 

public void setUsernamer Strinc username) { 
this.username = username; 

} 

public string getPassword'() { 
return password; 


} 
public void setPassword(String password) { 


this.password = password; 模型 ; (业务 对 象 JavaBean 对 象 ) 


} 包含 设置 /获取 数据 的 方法 
包含 业务 方法 


二 二 

* 因为 我 们 只 关注 表现 层 ， 此 处 只 是 模拟 ， 实 际 项 目 需要 改 掉 ! 
* Gparam username 用 户 名 

* @param password 密码 

* @return 

Ei 
public boolean login() { 


ift"zhang".equals(this.username) && "123".equals(this.password)) 


return true; 
} 


return false; 


视图 


<$Bpage import= "cn.7avass.chapteri. javabean .UserBeam'"s> 
< 上 Page lamguage= "javea" cortentType= "text/html; charset=UTF-8" 
payeEncoding="UTF-8"$> 
<IDOCTYPE ktml PUBLIC "~-//W3C//DID HINML 4.01 Transitional//EN" "http: //wwy.w3.org/TR/htmld/loose. dd"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content= "text/htnl, charset=UTF-8"> 
<title> 区 好 </title> 
<*/head> 
<body> 


<*form acticom='"$ {pageContext.request .corntextPath} /model2Login" method= "post "> 
<input type= "hidden" name="suwbnritFlag" value= "logim"/> 
usemame: <*input type="text" name= "wsermame'" value="${user.username} "/><br/> 
password: *input type="password" name= "passnord"/><br/> 
<input type= "submit" value= "logim"/> 


om 模型 展示 ,可 能 包含 一 些 展示 多 多 

Je 展示 逻辑 如 在 网 站 首页 
如 果 用 户 已 章 陆 ,显示 ”欢迎 访问 ,shuok” 
如 果 用 户 未 辣 陆 ,显示 ”欢迎 访问 ,游客 ” 
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控制 器 


Public class ModelZServlet extends HitpServlet { 
BOwverride 
Pprotected void doGet HttpServlethRequest redq, HtpServletResponse resp) 
throws ServletExcepticom, IDException { 
doPost (req，resp);// 为 了 简单 ， 直 楼 委 老 给 doPost 进行 处 埋 
} 
BOwverride 
protected void doPost'iHttpServlet Request red, HttpServlethResponse resp) 
throws ServletExcepticom, IDException { 
String submitFlayg = redq. getParameteri"submitFlag"); - 


ifi"toLoygin".equalsisubmitFlag)) { 控 皇 罗 辑 : 请 求 
toLoyginired, resp); \ 1、 辑 : 根据 RK 参 
retun; 数 选 择 要 执行 的 功能 方法 

} else ifi"login".equalsisubmitFlag)) 1{ S 


loyginired, resp); 
return; 
} 
toLogin (req，resp) ; // 跌 让 到 登录 页 面 
} 
private void toLoygin'HttpServlethRequest red, HtpServletResponse resp) 
throws ServletExcepticom, IDException { 
Z4 此 处 和 Jsp 视图 械 术 紧密 攀 襄 ， 更 搞 其 他 视图 技术 几乎 不 可 能 
red. get RequestDispatcher{" /mvec/login.jsp"). forwardiredqd, resp); 
} 
private void loyginiHttpServlet Request red, HttpServlethResponse resp) 
throws IOExcepticom, ServletException { 
A771 收 朱 戎 数 
String username = red. yetParameter ("username" 


Strinyg password = ed- get Parameter ("password" 2、 调用 业务 对 象 (javah ean 对 象 ) 进 


/7/2 验证 六 科 装 参数 重复 的 步 徽 ) 行 登录 : 即 模型 ， 不 仅 包 含 歼 据 还 
UserBean user = new UserBeani); | 包含 行为 
user.setUsemame (usermame); 


user.setPasswordl!password); 
Z73 凋 用 ] axrabean 对 象 〔 业 务 方 法 》 
ifiuser.logint)) { 
/4 根据 返回 位 选 俊 下 一 个 页 面 
resp.sendhRedirect (red- get ContextPathi) + "mvc/success.jsp"); 
} else { 
/登陆 类 败 朋 返回 登陆 页 面 ”六 嘲 示 上 上 忆 输 入 的 用 户 儿 


zy 插 视 图 村 史 示 的 模型 数据 效 在 诗 求 里 传递 给 视图 、 视 图 月 来 后 示 


/7 此 处 岂可 以 看 出 和 ServleE apI 昌 密 格 各 ， 更 的 得 加 某 林 类 逢 中 至 下 位 视 曾 妊 纤 异型 展示 ， 


red.sethttribuetl"user", user); 
toLogintreq, resp); 模型 数据 直接 放 在 red uest 里 





return; 


} 


从 Model2 架 构 可 以 看 出 ， 视 图 和 模型 分 离 了 ， 控 制 逻辑 和 展示 逻辑 分 离 了 。 
但 我 们 也 看 到 严重 的 缺点 
1 1、 控制 器 : 


1 1 1、 控 制 逻辑 可 能 比较 复杂 ， 其 实 我 们 可 以 按照 规约 ， 如 请 求 参 数 submitFlag=toAdd ， 
我 们 其 实 可 以 直接 调用 toAdd 方 法 ， 来 简化 控制 逻辑 ; 而 且 每 个 模块 基本 需要 一 个 控制 器 ， 造 
成 控制 逻辑 可 能 很 复杂 ; 


1. 1:2、 请 求 参 数 到 模型 的 封装 比较 麻烦 ， 如 果 能 交 给 框架 来 做 这 件 事 情 ， 我 们 可 以 从 中 得 


1. 1 3、 选 择 下 一 个 视图 ， 严 重 依赖 Servlet APl， 这 样 很 难 或 基本 不 可 能 更 换 视图 ; 


1. 1.4、 给 视图 传输 要 展示 的 模型 数据 ， 使 用 Servlet API， 更 换 视图 技术 也 要 一 起 更 换 ， 很 
麻烦 。 


、 模 型 : 


1 2. 1、 此 处 模型 使 用 JavaBean， 可 能 造成 JavaBean 组 件 类 很 庞大 ， 一 般 现在 项 目 都 是 采 
用 三 层 架 构 ， 而 不 采用 JavaBean 。 





JavaBean 组 件 等 价 于 ” 域 模型 层 + 业 务 迪 辑 层 + 持久 屋 
1.3、 视 图 


1: 3: 1、 现 在 被 绑 定 在 JSP， 很 难 更 换 视图 ， 比 如 Velocity、FreeMarker ; 比如 我 要 支持 


大 后 大 后 


Excel、PDF 视 图 等 寺 。 


1.4.5、 服 务 到 工作 者 : Front Controller + Application Controller + Page Controller + 
Context 


即 ， 前 端 控制 器 + 应 用 控制 器 + 页 面 控制 器 (也 有 称 其 为 动作 ) + 上 下 文 ， 也 是 Web MVC， 只 
是 责任 更 加 明确 ， 详 情 请 ww te EE 和 《企业 应 用 架构 模式 》 如 图 1-10 : 


页 面 控制 器 /命令 | 


| 
| 
蚁 全 孟 下 











， I 
| 
一 般 TlreadLocal 
模式 实现 


委 长 始 应 用 腕 制 矣 
根据 URL 选 你 入 面 控制 器 






1、 返 回避 短视 园 儿 
2 作品 攻 生 
证 以 保 丰 到 下 说 
报 声 页 而 控制 器 返 国 的 多 缉 视 图 避 选 你 相应 视 国 进 行 后 示 








全 -法 - 
只 页 : 

Front Controller : 前 端 控制 器 ， 负 责 为 表现 层 提供 统一 访问 点 ， 从 而 避免 Model2 中 出 现 的 重 
复 的 控制 逻辑 (由 前 端 控制 器 统一 回调 相应 的 功能 方法 ， 如 前 边 的 根据 submitFlag=login 转 调 
login 方 法 ) ; 并 且 可 以 为 多 个 请 求 提供 共用 的 逻辑 (如 准备 上 下 文 等 等 ) ， 将 选择 具体 视图 
和 具体 的 功能 处 理 〈 如 login 里 边 封装 请 求 参 数 到 模型 ， 并 调用 业务 逻辑 对 象 ) 分 离 。 
Application Controller : 应 用 控制 器 ， 前 端 控制 器 分 离 选择 具体 视图 和 具体 的 功能 处 理 之 

后 ， 需 要 有 人 来 管理 ， 应 用 控制 器 就 是 用 来 选择 具体 视图 技术 (视图 的 管理 ) 和 具体 的 功能 
处 理 〈 页 面 控制 器 /命令 对 象 /动作 管理 ) ， 一 种 策略 设计 模式 的 应 用 ， 可 以 很 容易 的 切换 视图 / 
页 面 控制 器 ， 相 互 不 产生 影响 。 

Page Controller(Command) : 页 面 控制 器 /动作 /处 理 器 : 功能 处 理 代 码 ， 收 集 参 数 、 封 装 参 
数 到 模型 ， 转 调 业 务 对 象 处 理 模型 ， 返 回 逻 辑 视图 名 交 给 前 端 控制 器 (和 具体 的 视图 技术 解 
厢 ) ， 由 前 端 控制 器 委托 给 应 用 控制 器 选择 具体 的 视图 来 展示 ， 可 以 是 命令 设计 模式 的 实 

现 。 页 面 控制 器 也 被 称 为 处 理 器 或 动作 。 

Context : 上 下 文 ， 还 记得 Model2 中 为 视图 准备 要 展示 的 模型 数据 吗 ， 我 们 直接 放 在 request 
中 (Servlet API 相 关 ) ， 有 了 上 下 文 之 后 ， 我 们 就 可 以 将 相关 数据 放置 在 上 下 文 ， 从 而 与 协 
议 无 关 (如 Servlet API) 的 访问 /设置 模型 数据 ， 一 般 通 过 ThreadLocal 模 式 实现 。 

到 此 ， 我 们 回顾 了 整个 web 开 发 架构 的 发 展 历程 ， 可 能 不 同 的 web 层 框架 在 细节 处 理 方面 不 
同 ， 但 的 目的 是 一 样 的 : 


干净 的 web 表 现 层 : 

模型 和 视图 的 分 离 ; 

控制 器 中 的 控制 逻辑 与 功能 处 理 分 离 (收集 并 封装 参数 到 模型 对 象 、 业 务 对 象 调用 ) ; 
控制 器 中 的 视图 选择 与 具体 视图 技术 分 离 。 


轻薄 的 Web 表现 层 : 
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做 的 事情 越 少 越 好 ， 薄 薄 的 ， 不 应 该 包含 无 关 代 码 ; 

只 负责 收集 并 组 织 参数 到 模型 对 象 ， 启 动 业 务 对 象 的 调用 ; 

控制 器 只 返回 逻辑 视图 名 并 由 相应 的 应 用 控制 器 来 选择 具体 使 用 的 视图 策略 ; 
尽量 少 使 用 框架 特定 API， 保 证 容易 测试 。 


到 此 我 们 了 解 Web MVC 的 发 展 历程 ， 接 下 来 让 我 们 了 解 下 Spring MVC 到 底 是 什么 、 架 构 及 来 
个 HelloWorld 了 解 下 具体 怎么 使 用 吧 。 


本 章 具体 代码 请 参考 springmvc-chapter1 工 程 。 
私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com) 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/5050.html]】 


第 二 章 Spring MVC 入 门 一 一 跟 开 涛 学 
SpringMVC 


2. 1、Spring Web MVC 是 什么 


Spring Web MVC 是 一 种 基于 Java 的 实现 了 Web MVC 设 计 模 式 的 请 求 驱动 类 型 的 轻 量 级 Web 
框架 ， 即 使 用 了 MVC 架 构 模 式 的 思想 ， 将 web 层 进行 职责 解 粮 ， 基 于 请 求 驱 动 指 的 就 是 使 用 
请 求 -响应 模型 ， 框 架 的 目的 就 是 帮助 我 们 简化 开发 ，Spring Web MVC 也 是 要 简化 我 们 日 党 
Web 开 发 的 。 


另外 还 有 一 种 基于 组 件 的 、 事 件 驱 动 的 Web 框 架 在 此 就 不 介绍 了 ， 如 Tapestry、JSF 等 。 


Spring Web MVC 也 是 服务 到 工作 者 模式 的 实现 ， 但 进行 可 优化 。 前 端 控制 器 

是 Dispatcherservlet ; 应 用 控制 器 其 实 拆 为 处 理 器 映射 器 (Handler Mapping) 进 行 处 理 器 管理 
和 视图 解析 器 (View Resolver) 进 行 视 图 管理 ; 页 面 控制 器 /动作 /处 理 器 为 Controller 接 口 ( 仅 包 
含 ModelAndview handleRequest(request, response) 方法 ) 的 实现 (也 可 以 是 任何 的 POJO 
类 ) ; 支持 本 地 化 (Locale) 解析 、 主 题 (Theme) 解析 及 文件 上 传 等 ; 提供 了 非常 灵活 的 
数据 验证 、 格 式 化 和 数据 绑 定 机 制 ; 提供 了 强大 的 约定 大 于 配置 (惯例 优先 原则 ) 的 契约 式 
编程 支持 。 


2 . 2、Spring Web MVC 能 帮 我 们 做 什么 
y 让 我 们 能 非常 简单 的 设计 出 干净 的 Web 层 和 薄 薄 的 Web 层 ; 
进行 更 简洁 的 Web 层 的 开发 ; 

JJ 天 生 与 Spring 框架 集成 (如 loC 容 器 、AOP 等 ) 

提供 强大 的 约定 大 于 配置 的 契约 式 编程 支持 ; 

能 简单 的 进行 Web 层 的 单元 测试 ; 

支持 灵活 的 URL 到 页 面 控制 器 的 映射 ; 


非常 容易 与 其 他 视图 技术 集成 ， 如 Velocity、FreeMarker 等 等 ， 因 为 模型 数据 不 放 在 特定 的 
APl 里 ， 而 是 放 在 一 个 Model 里 ( Map 数据 结构 实现 ， 因 此 很 容易 被 其 他 框架 使 用 ) 


非常 灵活 的 数据 验证 、 格 式 化 和 数据 绑 定 机 制 ， 能 使 用 任何 对 象 进行 数据 绑 定 ， 不 必 实 现 特 
定 框 架 的 API ; 


提供 一 套 强 大 的 JSP 标 签 库 ， 简 化 JSP 开 发 ; 


支持 灵活 的 本 地 化 、 主 题 等 解析 ; 
更 加 简单 的 异常 处 理 ; 

N 对 静态 资源 的 支持 ; 

支持 Restful 风 格 。 


2. 3、Spring Web MVC 和 架构 

Spring Web MVC 框 架 也 是 一 个 基于 请 求 驱动 的 Web 框 架 ， 并 且 也 使 用 了 前 端 控制 器 模式 来 进 
行 设计 ， 再 根据 请 求 映 射 规则 分 发 给 相应 的 页 面 控制 器 (动作 /处 理 器 ) 进行 处 理 。 首 先 让 我 
们 整体 看 一 下 Spring Web MVC 处 理 请 求 的 流程 : 


2.3.1、Spring Web MVC 处 理 请 求 的 流程 





如 图 2-1 
2、 委 托 请 求 给 处 理 器 
用 户 
7、 返 回 
控制 哇 
区 到 
三 邱 容器: 如 Tomcat 
图 2-1 
具体 执行 步骤 如 下 : 
1、 首先 用 户 发 送 请 求 一 一 一 -> 前 端 控制 器 ， 前 端 控制 器 根据 请 求 信息 (如 URL) 来 决定 选 


择 哪 一 个 页 面 控制 器 进行 处 理 并 把 请 求 委 托 给 它 ， 即 以 前 的 控制 器 的 控制 逻辑 部 分 ; 图 2-1 中 
的 1、2 步 骤 ; 


2、 页 面 控制 器 接收 到 请 求 后 ， 进 行 功能 处 理 ， 首 先 需要 收集 和 绑 定 请 求 参 数 到 一 个 对 象 ， 这 
个 对 象 在 Spring Web MVC 中 叫 命 令 对 象 ， 并 进行 验证 ， 然 后 将 命令 对 象 委 托 给 业务 对 象 进行 
处 理 ; 处 理 完毕 后 返回 一 个 ModelAndView (模型 数据 和 人 逻辑 视图 名 ) ; 图 2-1 中 的 3、4、5 步 
又 ; 


3、 前端 控制 器 收回 控制 权 ， 然 后 根据 返回 的 逻辑 视图 名 ， 选 择 相 应 的 视图 进行 泻 染 ， 并 把 模 
型 数据 传 入 以 便 视 图 浑 染 ; 图 2-1 中 的 步骤 6、7 ; 


4、 前 端 控制 器 再 次 收回 控制 权 ， 将 响应 返回 给 用 户 ， 图 2-1 中 的 步骤 8 ; 至 此 整个 结束 。 
问题 : 

1、 请 求 如 何 给 前 端 控制 器 ? 

2 、 前 端 控制 器 如 何 根据 请 求 信息 选择 页 面 控制 器 进行 功能 处 理 ? 

3、 如 何 支持 多 种 页 面 控制 器 呢 ? 

4、 如 何 页 面 控制 器 如 何 使 用 业务 对 象 ? 

5、 页 面 控制 器 如 何 返 回 模型 数据 ? 

6、 前端 控制 器 如 何 根据 页 面 控制 器 返回 的 逻辑 视图 名 选择 具体 的 视图 进行 泻 染 ? 

7、 不同 的 视图 技术 如 何 使 用 相应 的 模型 数据 ? 


首先 我 们 知道 有 如 上 问题 ， 那 这 些 问 题 如 何 解决 呢 ? 请 让 我 们 先 继续 ， 在 后 边 依次 回答 。 


2.3.2、Spring Web MVC 架 构 


1、Spring Web MVC 核 心 架构 图 ， 如 图 2-2 
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架构 图 对 应 的 DispatcherServlet 核 心 代码 如 下 : 


// 前 端 控制 器 分 派 方法 

protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throw 
HttpServletRequest processedRequest = request; 
HandlerExecutionChain mappedHandler = null; 


int interceptorIndex = -1; 


try { 
ModelAndView mv; 


boolean errorView = false; 


try { 

// 检 查 是 否 是 请 求 是 否 是 multipart (如 文件 上 传 ) ， 如 果 是 将 通过 Mu1ltipartResolver 解 
processedRequest = checkMultipart(request); 

// 步 又 2、 请 求 到 处 理 器 (页 面 控制 器 ) 的 映射 ， 通 过 HandlerMapping 进 行 映射 
mappedHandler = getHandler(processedRequest, false); 
If (mappedHandler == null || mappedHandler.getHandler() == null) { 

noHandlerFound(processedRequest, response); 

return; 


// 步 骤 3、 处 理 器 适 配 ， 即 将 我 们 的 处 理 器 包装 成 相应 的 适配器 〈 从 而 支持 多 种 类 型 的 处 理 器 ) 
HandlerAdapter ha = getHandlerAdapter(mappedHandler .getHandler()); 


// 304 Not Modified 绥 存 支持 
// 此 处 省 略 有 具体 代码 


// 执行 处 理 器 相关 的 拦截 器 的 预 处 理 (HandlerInterceptor.preHandle) 
// 此 处 省 略 有 具体 代码 


// 步骤 4、 由 适配器 执行 处 理 器 (调用 处 理 器 相应 功能 处 理 方法 ) 
mv = ha.handle(processedRequest，response，mappedHandJler .getHandler()); 


// Do we need view name translation? 
if (mv != null && !mv.hasView()) { 
mv.setViewName(getDefaultViewName(request)); 


} 
// 执行 处 理 器 相关 的 拦截 器 的 后 处 理 (HandlerInterceptor .postHandle) 
// 此 处 省 略 有 具体 代码 


catch (ModelAndViewDefiningException ex) { 
logger .debug("ModelAndViewDefiningException encountered", ex); 
mv = ex.getModelAndView( ) ; 


catch (Exception ex) { 
Object handler = (mappedHandler != null ? mappedHandler.getHandler() : nu 
mv = processHandlerException(processedRequest, response, handler, ex); 
errorView = (mv != null); 


y 


// 步 骤 5 步骤 6、 解 析 视 图 并 进行 视图 的 泻 染 
// 步 骤 5 由 ViewResolver 解 析 View (viewResolver.resolveViewName(viewName, locale)) 
// 步 骤 6 视图 在 演 染 时 会 把 Model 传 入 (view.render(mv.getModelInternal(), request, response);) 
If (mv != null && !mv,wasCleared()) { 
render (mv, processedRequest, response); 
if (errorView) { 
WebUtils.clearErrorRequestAttributes(request); 


} 
} 
else { 

if (logger.isDebugEnabled()) { 

logger.debug("Null ModelAndView returned to DispatcherServlet with na 
"'; assuming HandlerAdapter completed request handling"); 

} 
} 
// 执行 处 理 器 相关 的 拦截 器 的 完成 后 处 理 (HandlerInterceptor.afterCompletion) 
// 此 处 省 略 有 具体 代码 


catch (Exception ex) { 
// Trigger after-completion for thrown exception. 
triggerAfterCompletion(mappedHandler, interceptorIindex, processedRequest, res 
throw ex; 


catch (Error err) { 
ServletException ex = new NestedServletException("Handler processing failed", 
// Trigger after-completion for thrown exception. 


triggerAfterCompletion(mappedHandler, interceptorIindex, processedRequest, res 


throw ex; 
} 
finally { 
// Clean up any resources used by a multipart request. 
if (processedRequest != request) { 
cleanupMultipart(processedRequest ) ; 
} 
} 


“| = 


核心 架构 的 具体 流程 步骤 如 下 : 











1、 首先 用 户 发 送 请 求 一 一 >DispatcherServlet， 前 3 oS 器 收 到 请 求 后 自己 不 进行 处 理 ， 而 
是 委托 给 其 他 的 解析 器 进行 处 理 ， 作 为 统一 访问 点 ， 进 行 全 局 的 流程 控制 ; 





2、 DispatcherServlet >HandlerMapping ， ER 会 把 请 0 
HandlerExecutionChain 对 象 (包含 一 个 Handler 处 理 器 (页面 控制 器 ) 对 象 、 
Handlerlnterceptor 拦 截 器 ) 对 象 ， 通 过 这 种 策略 模式 ， 很 容易 添加 新 的 映射 策略 ; 


3、DispatcherServlet >HandlerAdapter ，HandlerAdapter 将 会 把 处 理 器 包装 为 适配器 ， 
从 而 支持 多 种 类 型 的 处 理 器 ， 即 适配器 设计 模式 的 应 用 ， 从 而 很 容易 支持 很 多 类 型 的 处 理 
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4、 HandlerAdapter 一 一 > 处 理 器 功能 处 理 方法 的 调用 ，HandlerAdapter 将 会 根据 适 配 的 结果 
调用 丰 正 的 处 理 器 的 功能 处 理 方法 ， 完 成 功能 处 理 ; 并 返回 一 个 ModelAndView 对 象 (包含 模 
型 数据 、 逮 辑 视图 名 ) ; 





5、ModelAndView 的 逻辑 视图 名 > ViewResolver ，ViewResolver 将 把 逻辑 视图 名 解析 为 
具体 的 View， 通 过 这 种 策略 模式 ， 很 容易 更 换 其 他 视图 技术 ; 








6、View > 泻 染 ，View 会 根据 传 进来 的 Model 模 型 数据 进行 泻 汪 ， 此 处 的 Model 实 际 是 一 
个 Map 数 据 结 构 ， 因 此 很 容 多 支持 其 他 视图 技术 ; 


7、 返 回 控制 权 给 DispatcherServlet ， 由 DispatcherServlet 返 回响 应 给 用 户 ， 到 此 一 个 流程 结 
束 。 


此 处 我 们 只 是 讲 了 核心 流程 ， 没 有 考虑 拦截 器 、 本 地 解析 、 文 件 上 传 解析 等 ， 后 边 再 细 述 。 
到 此 ， 再 来 看 我 们 前 边 提 出 的 问题 : 


1、 请 求 如 何 给 前 端 控制 器 ? 这 个 应 该 在 web.xml 中 进行 部 署 描述 ， 在 HelloWorld 中 详细 讲 
解 。 
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2、 前端 控制 器 如 何 根 据 请 求 信 息 选择 页 面 控制 
HandlerMapping 进 行 映射 


进行 功能 处 理 ? 我 们 需要 配置 


3、 如 何 支持 多 种 页 面 控制 器 呢 ? 配置 HandlerAdapter 从 而 支持 多 种 类 型 的 页 面 控制 器 


4、 如 何 页 面 控制 器 如 何 使 用 业务 对 象 ? 可 以 预料 到 ， 肯 定 利用 Spring loC 容 器 的 依赖 注入 功 


bh- 
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5、 页 面 控制 器 如 何 返回 模型 数据 ?使 用 ModelAndView 返 回 


6 、 前 端 控制 器 如 何 根 据 页 面 控制 器 返回 的 逻辑 视图 名 选择 具体 的 视图 进行 泻 染 ? 使 用 
ViewResolver 进 行 解析 


7、 不同 的 视图 技术 如 何 使 用 相应 的 模型 数据 ? 因为 Model 是 一 个 Map 数 据 结构 ， 很 容易 支持 
其 他 视图 技术 


在 此 我 们 可 以 看 出 具体 的 核心 开发 步骤 : 

1、DispatcherServlet 在 web.xml 中 的 部 署 描 述 ， 从 而 拦截 请 求 到 Spring Web MVC 
2、HandlerMapping 的 配置 ， 从 而 将 请 求 映射 到 处 理 器 

3、HandlerAdapter 的 配置 ， 从 而 支持 多 种 类 型 的 处 理 器 

4、 ViewResolver 的 配置 ， 从 而 将 逻辑 视图 名 解析 为 具体 视图 技术 

5、 处 理 器 (页面 控制 器 ) 的 配置 ， 从 而 进行 功能 处 理 


上 边 的 开发 步骤 我 们 会 在 Hello World 中 详细 验证 。 


2. 4、Spring Web MVC 优 势 


1、 清 晰 的 角色 划分 : 前 端 控制 器 ( Dispatcherservlet ) 、 请 求 到 处 理 器 映射 

人 RD 、 处理 器 适配器 (HandlerAdapter) 、 视 图 解析 器 (ViewResolver) 、 
处 理 器 或 页 面 控制 器 (Controller) 、 验 证 器 ( Validator) 、 命 令 对 象 (Command 请 求 参数 
绑 定 到 的 寺 训 由 叫 兴 令 对 象 ) 、 表 单 对 象 (Form Object 提供 给 表单 展示 和 提交 到 的 对 象 就 叫 
表单 对 象 ) 。 


2、 分 工 明 确 ， 而 且 扩 展 点 相当 灵活 ， 可 以 很 容易 扩展 ， 虽 然 几 乎 不 需要 ; 


3、 由 于 命令 对 象 就 是 一 个 POJO， 无 需 继承 框架 特定 API， 可 以 使 用 命令 对 象 直接 作为 业务 对 
象 ; 


4、 和 Spring 其 他 框架 无 缝 集成， 是 其 它 Web 框 架 所 不 具备 的 ; 

5、 可 适 配 ， 通 过 HandlerAdapter 可 以 支持 任意 的 类 作为 处 理 器 ; 

6、 可 定制 性 ，HandlerMapping、ViewResolver 等 能 够 非常 简单 的 定制 
7、 功 能 强大 的 数据 验证 、 格 式 化 、 绑 定 机 制 ; 


利用 Spring 提供 的 Mock 对 象 能 够 非常 简单 的 进行 Web 层 单元 测试 ; 


9、 本 地 化 、 主 题 的 解析 的 支持 ， 使 我 们 更 容易 进行 国际 化 和 主题 的 切换 。 
10、 强 大 的 JSP 标 签 库 ， 使 JSP 编 写 更 容易 。 


ee 还 有 比如 RESTful 风 格 的 支持 、 简 单 的 文件 上 传 、 约 定 大 于 配置 的 契约 式 编程 支 
持 、 基 于 注解 的 零 配 置 支持 等 等 。 


到 此 我 们 已 经 简单 的 了 解 了 Spring Web MVC， 接 下 来 让 我 们 来 个 实例 来 具体 使 用 下 这 个 框 


架 。 


2. 5、Hello World 入 门 


2.5.1、 准 备 开发 环境 和 运行 环境 : 
交 开 发 工具 : eclipse 

交 和 运行 环境 : tomcat6.0.20 

六 工程 : 动态 Web 工 程 (springmvc-chapter2) 
交 spring 框 架 下 载 : 
spring-framework-3.1.1.RELEASE-with-docs.zip 
次 依赖 jar 包 : 

1、 Spring 框 架 jar 包 : 


为 了 简单 ， 将 spring-framework-3.1.1.RELEASE-with-docs.zip/dist/ 下 的 所 有 jar 包 拷贝 到 项 目 
的 WEB-INF/lib 目 录 下 ; 


2、Spring 框 架 依 赖 的 jar 包 : 
需要 添加 Apache commons logging 日 志 ， 此 处 使 用 的 是 commons.logging-1.1.1Jjar ; 


需要 添加 jstl 标 签 库 支 持 ， 此 处 使 用 的 是 jstl-1.1.2.jar 和 standard-1.1.2Jjar ; 


2.5.2、 前 端 控 制 器 的 配置 


在 我 们 的 web.xml 中 添加 如 下 配置 : 


<servlet> 
<servlet-name>chapter2</servlet-name> 
<servlet-class>org.springframework.web.servilet.DispatcherServlet</servlet-class> 
<load-on-startup>1</load-on-startup> 

</servlet> 

<servlet-mapping> 
<servlet-name>chapter2</servlet-name> 
<url-pattern>/</url-pattern> 

</servlet-mapping> 


1 一 侈 '] 





load-on-startup : 表示 局 动容 器 时 初始 化 该 Servlet ; 


url-pattern : 表示 哪些 请 求 交 给 Spring Web MVC 处 理 ，“/" 是 用 来 定义 默认 servlet 映 射 的 。 
也 可 以 如 html" 表示 拦 截 所 有 以 htm| 为 扩展 名 的 请 求 。 


自 此 请 求 已 交 给 Spring Web MVC 框 架 处 理 ， 因 此 我 们 需要 配置 Spring 的 配置 文件 ， 黑 认 
DispatcherServlet 会 加 载 WEB-INF/[DispatcherServlet 的 Servlet 名 字 ]-servlet.xml 配 置 文件 。 
本 示例 为 WEB-INF/ chapter2-servlet.xml 。 


2.5.3、 在 Spring 配 置 文件 中 配置 HandlerMapping、 
HandlerAdapter 


具体 配置 在 WEB-INF/ chapter2-servlet.xml 文 件 中 : 


<!-- HandlerMapping --> 
<bean class="org.springframework.web.servlet.handler .BeanNameUrlHandlerMapping"/> 


<!-- HandlerAdapter --> 
<bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/> 


BeanNameUrlHandlerMapping : 表示 将 请 求 的 URL 和 Bean 名 字 映 射 ， 如 URL 为 “上 下 
文 /hello”， 则 Spring 配 置 文件 必须 有 一 个 名 字 为 “/hello” 的 Bean， 上 下 文 默认 忽略 。 


SimpleControllerHandlerAdapter : 表示 所 有 实现 了 
org.springframework.web.servlet.mvc.Controller 接 口 的 Bean 可 以 作为 Spring Web MVC 中 的 
处 理 器 。 如 果 需 要 其 他 类 型 的 处 理 器 可 以 通过 实现 HadlerAdapter 来 解决 。 


2.5.4、 在 Spring 配置 文件 中 配置 ViewResolver 
具体 配置 在 WEB-INF/ chapter2-servlet.xml 文 件 中 : 


<!-- ViewResolver --> 

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> 
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> 
<property name="prefix" value="/WEB-INF/jsp/"/> 
<property name="suffix" value=".jsp"/> 

</bean> 


InternalResourceViewResolver : 用 于 支持 Servlet、JSP 视 图 解析 ; 


viewClass : JstlView 表 示 JSP 模 板 页 面 需要 使 用 JSTL 标 签 库 ，classpath 中 必须 包含 jstl 的 相关 
jar 包 ; 


prefix 和 suffix : 查找 视图 页 面 的 前 级 和 后 级 〈 前 组 [逻辑 视图 名 ] 后 级 ) ， 比 如 传 进来 的 逻辑 视 
图 名 为 hello， 则 该 该 jsp 视 图 页 面 应 该 存放 在 “WEB-INF/jsp/hello.jsp”; 


2.5.5、 开 发 处 理 器 /页 面 控制 器 


package cn.javass.chapter2.web.controller; 
import javax.servlet.http.HttpServletRequest; 
Import javax.servlet.http.HttpServletResponse; 
import org.springframework .web.servilet.ModelAndView; 
import org.springframework.web.servilet.mvc.Controller; 
public class HelloworldController implements Controller { 
Q@Override 
public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) t 
//1、 收 集 参 数 、 验 证 参数 
//2、 绑 定 参数 到 命令 对 象 
//3、 将 命令 对 象 传 入 业务 对 象 进行 业务 处 理 
//4、 选 择 下 一 个 页 面 
ModelAndView mv = new ModelAndView( ); 
// 添 加 模型 数据 可 以 是 任意 的 POJO 对 象 
mv.addobject("message", "Hello World!"); 
// 设 置 逻 辑 视图 名 ， 视 图 解析 器 会 根据 该 名 字 解 析 到 具体 的 视图 页 面 
mv.setViewName("hello"); 
return mv; 





org.springframework.web.servlet.mvc.Controller : 页 面 控制 器 /处 理 器 必须 实现 Controller 接 
口 ， 注 意 别 选 错 了 ; 后 边 我 们 会 学 习 其 他 的 处 理 器 实现 方式 ; 


public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) 
: 功能 处 理 方法 ， 实 现 相 应 的 功能 处 理 ， 比 如 收集 参数 、 验 证 参数 、 绑 定 参 数 到 命令 对 象 、 
将 命令 对 象 传 入 业务 对 象 进行 业务 处 理 、 最 后 返回 ModelAndView 对 象 ; 


ModelAndView : 包含 了 视图 要 实现 的 模型 数据 和 逻辑 视图 名 ; “mv.addObject("message", 
"Hello World!"); 


"表示 添加 模型 数据 ， 此 处 可 以 是 任意 POJO 对 象 ; “mv.setViewName("hello");”" 表 示 设 置 逻 辑 
视图 名 为 “hello"， 视 图 解析 器 会 将 其 解析 为 具体 的 视图 ， 如 前 边 的 视图 解析 器 
InternalResourceVi。wResolver 会 将 其 解析 为 “WEB-INF/jsp/hello.jsp”。 


我 们 需要 将 其 添加 到 Spring 配置 文件 (WEB-INF/chapter2-servlet.xml)， 让 其 接受 Spring loC 容 


BR 和 


颈 官 理 : 


> 
<bean name="/hello" class="cn.javass.chapter2.web.controller.HelloworldController"/> 


name="hello" : 前 边 配 置 的 BeanNameUrlHandlerMapping， 表 示 如 过 请 求 的 URL 为 “上 下 
文 /hello”， 则 将 会 交 给 该 Bean 进 行 处 理 。 


2.5.6、 开 发 视图 页 面 
创建 /WEB-INF/jsp/hello.jsp 视 图 页 面 : 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN™" "http://www.w3.org/TR/html 
<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 

<title>Hello World</title> 

</head> 

<body> 

${message} 

</body> 

</html> 


本 一 -一 


${message} : 表示 显示 由 HelloWorldController 处 理 器 传 过 来 的 模型 数据 。 





2.5.6、 司 动 服务 器 运行 测试 


通过 请 求 : http://localhost:9080/springmvc-chapter2/hello， 如 果 页 面 输出 “Hello World! "就 表 
明 我 们 成 功 了 ! 


1、 发 送 请 
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图 2-3 


运行 步骤 : 


1、 首先 用 户 发 送 请 求 http://localhost:9080/springmvc-chapter2/hello 一 一 >web 容 器 ，Web 容 


器 根据 “/hello” 路 径 映 射 到 DispatcherServlet (url-pattern 为 /) 进行 处 理 ; 








2、 DispatcherServlet 一 一 >BeanNameUrlHandlerMapping 进 行 请 求 到 处 理 的 映射 ， 
BeanNameUrlHandlerMapping 将 “/hello” 路 径直 接 映 射 到 名 字 为 “/hello” 的 Bean 进 行 处 理 ， 即 
HelloWorldController， BeanNameUrlHandlerMapping 将 其 包装 为 

HandlerExecutionChain (只 包括 HelloWorldController 处 理 器 ， 没 有 拦截 器 ) ; 





3、 DispatcherServlet > SimpleControllerHandlerAdapter ， 
SimpleControllerHandlerAdapter 将 HandlerExecutionChain 中 的 处 理 器 
(HelloWorldController) 适 配 为 SimpleControllerHandlerAdapter ; 





4、SimpleControllerHandlerAdapter > HelloWorldController 处 理 器 功能 处 理 方法 的 调 
用 ，SimpleControllerHandlerAdapter 将 会 调用 处 理 器 的 handleRequest 方 法 进行 功能 处 理 ， 
该 处 理 方法 返回 一 个 ModelAndView 给 DispatcherServlet ; 





5、hello (ModelAndView 的 逻辑 视图 名 ) >InternalResourceViewResolver »; 
InternalResourceViewResolver 使 用 JstlView， 具 体 视 图 页 面 在 /WEB-INF/jsp/hello.jsp ; 


6 、JstlView (/WEB-INF/jsp/hello.jsp) 一 “> 泻 染 ， 将 在 处 理 器 传 入 的 模型 数据 
(message=HelloWorld ! ) 在 视图 中 展示 出 来 ; 





7、 返回 控制 权 给 DispatcherServlet， 由 DispatcherServlet 返 回响 应 给 用 户 ， 到 此 一 个 流程 结 
束 。 


到 此 HelloWorld 就 完成 了 ， 步 又 是 不 是 有 点 多 ? 而 且 回 忆 下 和 载 们 主要 进行 了 如 下 配置 : 
1、 前 端 控制 器 DispatcherServlet ; 

2、 HandlerMapping 

3、 HandlerAdapter 

4、ViewResolver 

5、 处 理 器 /页 面 控制 器 

6、 视 图 


因此 ， 接 下 来 几 章 让 我 们 详细 看 看 这 些 配 置 ， 先 从 DispatcherServlet 开 始 吧 。 


2 . 6、POST 中 文 乱码 解决 方案 


spring Web MVC 框 架 提 供 了 org.springframework.web.filterCharacterEncodingFilter 用 于 解决 
POST 方式 造成 的 中 文 乱码 问题 ， 具 体 配置 如 下 : 


fliten> 
<filter-name>CharacterEncodingFilter</filter-name> 
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 
<init-param> 
<param-name>encoding</param-name> 
<param-value>utf-8</param-value> 
</init-param> 
</filter> 
<filter-mapping> 
<filter-name>CharacterEncodingFilter</filter-name> 
<url-pattern>/*</url-pattern> 
</filter-mapping> 


4 | 


以 后 我 们 项 目 及 所 有 页 面 的 编码 均 为 UTF-8。 





2.7、Spring3.1 新 特性 


** 一 、Spring2.5 之 前 ， 我 们 都 是 通过 实现 Controller 接 口 或 其 实现 来 定义 我 们 的 处 理 器 类 。** 

** 二 、Spring2.5 引 入 注解 式 处 理 器 支持 ， 通 过 @Controller 和 @RequestMapping 注 解 定义 我 们 的 处 理 器 类 。 并 且 换 
需要 通过 处 理 器 映射 DefaultAnnotationHandlerMapping 和 处 理 器 适配器 AnnotationMethodHandlerAdapter 来 
@Controller : ”用 于 标识 是 处 理 器 类 ; 

@RequestMapping : 请求 到 处 理 器 功能 方法 的 映射 规则 ; 

@RequestParam : 、` 请 求 参数 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ; 

@ModelAttribute : `` 请 求 参 数 到 命令 对 象 的 绑 定 ; 

@SessionAttributes : 用 于 声明 session 级 别 存储 的 属性 ， 放 置 在 处 理 器 类 上 ， 通 常 列 出 模型 属性 (如 @ModelAttr 
@InitBinder :`` 自 定义 数据 绑 定 注册 支持 ， 用 于 将 请 求 参数 转换 到 命令 对 象 属性 的 对 应 类 型 ; 

*x 三 “Spring3.0 引 入 RESTfu1 架 构 风 格 支持 (通过 @PathVariab1le 注 解 和 一 些 其 他 特性 支持 ) ， 且 又 引入 了 更 多 的 注解 支 
@Ccookievalue :cookie 数据 到 处 理 器 功能 处 理 方 法 的 方法 参数 上 的 绑 定 ; 

@RequestHeader : `` 请 求 头 (header ) 数据 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ; 

@RequestBody :“` 请 求 的 body 体 的 绑 定 (通过 HttpMessageConverter 进 行 类 型 转换 ) ，; 

@ResponseBody :“` 处 理 器 功能 处 理 方法 的 返回 值 作为 响应 体 (通过 HttpMessageConverter 进 行 类 型 转换 ) ; 
@ResponseStatus : “定义 处 理 器 功能 处 理 方法 /异常 处 理 器 返回 的 状态 码 和 原因 ; 

@ExceptionHandler : 注解 式 声 明 异 常 处 理 器 ; 

@PathVariable : 请求 URI 中 的 模板 变量 部 分 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ， 从 而 支持 RESTfu1 架 构 风 格 
xx 四 、 还 有 比如 : ** 

JSR-303 验 证 框架 的 无 缝 支持 (通过 @Valid 注 解 定义 验证 元 数据 ) ; 


使 用 Spring 3 开始 的 ConversionService 进 行 类 型 转换 ( PropertyEditor 依 然 有 效 ) ， 支 持 使 用 
@NumberFormat 和 @DateTimeFormat 来 进行 数字 和 日 期 的 格式 化 ; 


HttpMessageConverter` (Http 输入 /输出 转换 器 ， 比 如 JSON、XML 等 的 数据 输出 转换 器 ) ; 
ContentNegotiatingViewResolver``， 内 容 协商 视图 解析 器 ， 它 还 是 视图 解析 器 ， 只 是 它 支持 根据 请 求 信息 将 同一 模 
Spring 3 引入 一 个 mvc XML 的 命名 空间 用 于 支持 mvc 配 置 ， 包 括 如 : 

&lt;mvc:annotation-driven&gt;: 

自动 注册 基于 注解 风格 的 处 理 器 需要 的 DefaultAnnotationHandlerMapping、AnnotationMethodHandlerAdapte 
支持 Spring3 的 ConversionService 自 动 注册 

支持 JSR-303 了 验证 框架 的 自动 探测 并 注册 (只 需 把 JSR-393 实 现 放 置 到 classpath) 

自动 注册 相应 的 HttpMessageConverter (用 于 支持 @RequestBody 和 @ResponseBody) (如 XML 输 入 输出 转换 器 
&lt;mvc:interceptors&gt; : 注册 自 定义 的 处 理 器 拦截 器 ; 

&lt;mvc:view-controller&gt; : 和 ParameterizableViewController 类 似 ， 收 到 相应 请 求 后 直接 选择 相应 的 视 


<mvc:resources> : 逻辑 静态 资源 路 径 到 物理 静态 资源 路 径 的 支持 ; 


<mvc:default-servlet-handler> : 当 在 web.xml 中 DispatcherServlet 使 用 <url-pattern>/</url- 
pattern> 映射 时 ， 能 映射 静态 资源 ( 当 Spring Web MVC 框 架 没有 处 理 请 求 对 应 的 控制 器 时 
(如 一 些 静 态 资 源 ) ， 和 转交 给 默认 的 Servlet 来 响应 静态 文件 ， 否 则 报 404 找 不 到 资源 错 


误 ，) 。 


“4 SDring3 1 六 特 性 

对 Servlet 3.0 的 全 面 支持 。 

@EnablewebMvc : ` 用 于 在 基于 Java 类 定义 Bean 配 置 中 开启 MVC 支 持 ， 和 XML 中 的 &lt;mvc:annotation-driven&gt 
新 的 @QContoller 和 @RequestMapping 注 解 支持 类 : 处 理 器 映射 RequestMappingHandlerMapping 和 处 理 器 适配器 
新 的 @QExceptionHandler 注解 支持 类 : ExceptionHandlerExceptionResolver 来 代替 Spring3.9 的 Annotationl 
@RequestMapping 的 "consumes" 和 "produces" 条 件 支持 : ` 用 于 支持 @RequestBody 和 @ResponseBody， 
1` “consumes`` 指 定 请 求 的 内 容 是 什么 类 型 的 内 容 ， 即 本 处 理 方 法 消费 什么 类 型 的 数据 ， 如 consumes="application/ 
2``produces`` 指 定 生 产 什么 类 型 的 内 容 ， 如 produces="application/json" 表 示 JSON 类 型 的 内 容 ，Spring 的 根据 
3 ,以 上 内 容 ， 本 章 第 xxx 节 详 述 。 

URI 模 板 变 量 增强 :“ “URI 模 板 变 量 可 以 直接 绑 定 到 @ModelAttribute 指 定 的 命令 对 象 、@PathVariable 方 法 参数 在 视 E 
@Validated :``JSR-303 的 javax.validation.Valid 一 种 变 体 ( 非 JSR-303 规 范 定义 的 ， 而 是 Spring 自 定义 的 ) ， 
@RequestPart :“ ` 提 供 对 “multipart/form-data” 请 求 的 全 面 支持 ， 支 持 Servlet 3.0 文 件 上 传 (javax.servlet 
Flash 属性 和 RedirectAttribute :`` 通 过 FlashMap 存 储 一 个 请 求 的 输出 ， 当 进入 另 一 个 请 求 时 作为 该 请 求 的 输入 


Spring Web MVC 提 供 FlashMapManager 用 于 管理 FlashMap， 默 认 使 用 SessionFlashMapManager， 即 数 
据 上 默认 存储 在 session 中 。 


私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com) 


跟 我 学 Spring 系列 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/5160.html] 
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第 三 章 DispatcherServlet 详 解 一 一 跟 开 涛 学 
SpringMVC 


3.1、DispatcherServlet 作 用 


DispatcherServlet 是 前 端 控制 器 设计 模式 的 实现 ， 提 供 Spring Web MVC 的 集中 访问 点 ， 而 且 
负责 职责 的 分 派 ， 而 且 与 Spring loC 容 器 无 缝 集 成， 从 而 可 以 获得 Spring 的 所 有 好 处 。 具体 请 
参考 第 二 章 的 图 2-1 。 


DispatcherServlet 主 要 用 作 职 责 调度 工作 ， 本 身 主 要 用 于 控制 流程 ， 主 要 职责 如 下 : 
1、 文 件 上 传 解 析 ， 如 果 请 求 类 型 是 multipart 将 通过 MultipartResolver 进 行文 件 上 传 解析 ; 


2、 通 过 HandlerMapping， 将 请 求 映 射 到 处 理 器 (返回 一 个 HandlerExecutionChain， 它 包括 
一 个 处 理 器 、 多 个 Handlerlnterceptor 拦 截 器 ) ; 


3、 通 过 HandlerAdapter 支 持 多 种 类 型 的 处 理 器 (HandlerExecutionChain 中 的 处 理 器 ) ; 
4、 通 过 ViewResolver 解 析 逻 辑 视图 名 到 有 具体 视图 实现 ; 

5、 本 地 化 解析 ; 

6、 演 染 具 体 的 视图 等 ; 

7、 如 果 执 行 过 程 中 遇 到 异常 将 交 给 HandlerExceptionResolver 来 解析 。 


从 以 上 我 们 可 以 看 出 DispatcherServlet 主 要 负责 流程 的 控制 〈 而 且 在 流程 中 的 每 个 关键 点 都 是 
很 容易 扩展 的 ) 。 


3.2、DispatcherServlet 在 web.xml 中 的 配置 


<servlet> 
<servlet-name>chapter2</servlet-name> 
<servlet-class>org.springframework.web,.servlet.DispatcherServlet</servlet-class> 
<load-on-startup>1</load-on-startup> 

</servlet> 

<servlet-mapping> 
<servlet-name>chapter2</servlet-name> 
<url-pattern>/</url-pattern> 

</servlet-mapping> 


CCE ，)D 
load-on-startup : 表示 启动 容器 时 初始 化 该 Servlet ; 


url-pattern : 表示 哪些 请 求 交 给 Spring Web MVC 处 理 ，“/" 是 用 来 定义 默认 servlet 映 射 的 。 
也 可 以 如 近 .html" 表 示 拦 截 所 有 以 htm| 为 扩展 名 的 请 求 。 


该 DispatcherServlet 默 认 使 用 WebApplicationContext 作 为 上 下 文 ，Spring 默 认 配 置 文件 
为 “WEB-INF/[servlet 名 字 ]-servlet.xml”。 


DispatcherServlet 也 可 以 配置 自己 的 初始 化 参数 ， 禾 盖 默 认 配 置 : 
摘自 Spring Reference 
参数 首 述 


实现 WebApplicationContext 接 口 的 类 ， 当 前 的 servlet 用 它 来 创 
contextClass 建 上 下 文 。 如 果 这 个 参数 没有 指定 ， 默认 使 用 
XmlWebApplicationContext 。 


传 给 上 下 文 实例 (由 contextClass 指 定 ) 的 字符 串 ， 用 来 指定 
上 下 文 的 位 置 。 这 个 字符 串 可 以 被 分 成 多 个 字符 串 (使 用 各 号 
ConexXtCon g 0Ca non 作为 分 隔 符 ) 来 支持 多 个 上 下 文 (在 多 上 下 文 的 情况 下 ， 如 果 
同一 个 bean 被 定义 两 次 ， 后 面 一 个 优先 ) 。 


WebApplicationContext 命 名 空间 。 默 认 值 是 [server-name]- 


namespace 
Servlet 。 


此 我 们 可 以 通过 添加 初始 化 参数 


<servlet> 
<servlet-name>chapter2</servlet-name> 
<servlet-class>org.springframework.web,.servlet.DispatcherServlet</servlet-class> 
<load-on-startup>1</load-on-startup> 
<init-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>classpath:spring-servlet-config.xml</param-value> 
</init-param> 
</servlet> 


国定 于 一 = 


如 果 使 用 如 上 配置 ，Spring Web MVC 框 架 将 加 载 “classpath:spring-servlet-config.xml" 来 进 
初始 化 上 下 文 而 不 是 “WEB-INF/[servlet 名 字 ]-servlet.xml”。 


3.3、 上 下 文 关 系 
集成 Web 环 境 的 通用 配置 : 


<context-param> 
<param-name>contextCconfigLocation</param-name> 
<param-value> 
classpath:spring-common-config.xml, 
classpath:spring-budget-config.xml 
</param-value> 
</context-param> 
<listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listen 
</listener> 





加 





如 上 配置 是 Spring 集成 Web 环 境 的 通用 配置 ; 一 般 用 于 加 载 除 Web 层 的 Bean (如 DAO、 
Service 等 ) ， 以 便于 与 其 他 任何 Web 框 架 集 成 。 


contextConfigLocation : 表示 用 于 加 载 Bean 的 配置 文件 ; 


contextClass : 表示 用 于 加 载 Bean 的 ApplicationContext 实 现 类 ， 黑 认 
WebApplicationContext 。 


创建 完毕 后 会 将 该 上 下 文 放 在 ServletContext : 

servletContext.setAttribute( 
WebApplicationContext.ROOT_ WEB_ APPLICATION_ CONTEXT_ATTRIBUTE, 
this.context); 


ContextLoaderListener 初 始 化 的 上 下 文 和 DispatcherServlet 初 始 化 的 上 下 文 关 系 ， 如 图 3-1 
1、 初 始 化 通用 上 下 文 


Parent 





Dispatcher 
Servlet 


| 
| 


Web 容 器 : 如 Tomeat 





图 3-1 
从 图 中 可 以 看 出 : 


ContextLoaderListener 初 始 化 的 上 下 文 加 载 的 Bean 是 对 于 整个 应 用 程序 共享 的 ， 不 管 是 使 用 
什么 表现 层 技术 ， 一 般 如 DAO 层 、Service 层 Bean ; 


DispatcherServlet 初 始 化 的 上 下 文 加 载 的 Bean 是 只 对 Spring Web MVC 有 效 的 Bean， 如 
Controller、HandlerMapping、HandlerAdapter 等 等 ， 该 初始 化 上 下 文 应 该 只 加 载 Web 相 关 组 
件 。 


3.4、DispatcherServlet 初 始 化 顺序 


继承 体系 结构 如 下 所 示 : 
口 OO HttpServlet 


日 -© Es 
日 FrameworkS ervlet 


由 -只 ni spatcherServlet 


1、HttpServletBean 继 承 HttpServlet， 因 此 在 Web 容 器 启动 时 将 调用 它 的 init 方 法 ， 该 初始 
化 方法 的 主要 作用 


: 将 Servlet 初 始 化 参数 (init-param) 设置 到 该 组 件 上 (如 contextAttribute、 
contextClass、namespace、contextConfigLocation) ， 通 过 BeanWrapper 简 化 设 值 过 程 ， 方 
便 后 续 使 用 ; 


全 


是 供给 予 类 初始 化 扩展 点 ，initServletBean()， 该 方法 由 FrameworkServlet 履 盖 。 


public abstract class HttpServletBean extends HttpServlet implements EnvironmentAwaret 
Q@Override 
public final void init() throws ServletException { 
// 省 略 部 分 代码 
//1、 如 下 代码 的 作用 是 将 Servlet 初 始 化 参数 设置 到 该 组 件 上 
// 如 contextAttribute 、 contextCclass ~、 namespace 、 contextConfigLocation; 
try { 
PropertyValues pvs = new ServletConfigPropertyValues(getServletCconfig(), this. 
Beanwrapper bw = PropertyAccessorFactory.forBeanpropertyAccess(this); 
ResourceLoader resourceLoader = new ServletContextResourceLoader(getServletCon 
bw.registerCustomEditor(Resource.class, new ResourceEditor(resourceLoader, thi 
initBeanWrapper (bw); 
bw.setPropertyValues(pvs, true); 


catch (BeansException ex) { 
/人 省 略 其 他 代码 


//2、 提 供给 予 类 初始 化 的 扩展 点 ， 该 方法 由 FrameworkServ1Let 禾 盖 
initServletBean(); 
if (logger.isDebugEnabled()) { 
logger.debug("Servilet '" + getServletName() + "' configured successfully"); 
J 


} 
/1…… 省略 其 他 代码 





2、FrameworkServlet 继 承 HttpServletBean ， 通过 initServletBean() 进 行 Web 上 下 文 初始 
化 ， 该 方法 主要 窗 盖 一 下 两 件 事 情 : 


初始 化 web 上 下 文 ; 


提供 给 子 类 初始 化 扩展 点 ; 


public abstract class FrameworkServlet extends HttpServletBean { 
@Override 
protected final void initServletBean() throws ServletException { 
// 省 略 部 分 代码 
try { 
//1、 初 始 化 Web 上 下 文 
this.webApplicationContext = initwebApplicationContext(); 
//2、 提 供给 子 类 初始 化 的 扩展 点 
initFrameworkServlet(); 


D 
// 省 略 部 分 代码 


protected WebApplicationContext initwebApplicationContext() { 
//RO0T 上 下 文 (ContextLoaderListener 加 载 的 ) 
WebApplicationContext rootContext = 
WebApplicationContextUtils.getwebApplicationContext(getServletCcontext()); 
WebApplicationContext wac = null; 
if (this.webApplicationContext != null) { 
// 1、 在 创建 该 Servlet 注 入 的 上 下 文 
wac = this.webApplicationContext; 
if (wac instanceof ConfigurablewebApplicationContext) { 
ConfigurablewebApplicationContext cwac = (ConfigurablewebApplicationContext 
if (!cwac.isActive()) { 
if (cwac.getParent() == null) { 
cwac.setParent(rootContext); 
} 


configureAndRefreshwebApplicationContext(cwac); 
yD 
} 
} 
if (wac == null) { 
//2、 查 找 已 经 绑 定 的 上 下 文 
wac = findwebApplicationContext(); 
} 
if (wac == null) { 
//3、 如 果 没 有 找到 相应 的 上 下 文 ， 并 指定 父亲 为 ContextLoaderListener 
wac = createwebApplicationContext(rootContext); 


If (!this.refreshEventReceived) { 
/V/4、 刷 新 上 下 文 〈 执 行 一 些 初 始 化 ) 
onRefresh(wac ) ; 


} 

if (this.publishContext) { 
// Publish the context as a servlet context attribute. 
String attrName = getServletContextAttributeName(); 
getServletcontext().setAttribute(attrName, wac); 
// 省 略 部 分 代码 

} 


return wac; 





从 initWebApplicationContext ( ) 方法 可 以 看 出 ， 基 本 上 如 果 ContextLoaderListener 加 载 了 上 
下 文 将 作为 根 上 下 文 (DispatcherServlet 的 父 容器 ) 。 


最 后 调用 了 onRefresh() 方 法 执行 容器 的 一 些 初 始 化 ， 这 个 方法 由 子 类 实现 ， 来 进行 扩展 。 


3、DispatcherServlet 继 承 FrameworkServlet， 并 实现 了 onRefresh() 方 法 提供 一 些 前 端 控 
制 器 相关 的 配置 : 


public class DispatcherServlet extends FrameworkServlet { 
// 实 现 子 类 的 onRefresh( ) 方 法 ， 该 方法 委托 为 initStrategies() 方 法 。 
@Override 
protected void onRefresh(ApplicationContext context) { 
initStrategies(context); 


} 


// 初 始 化 默认 的 Spring Web MVC 框 架 使 用 的 策略 (如 HandlerMapping) 
protected void initStrategies(ApplicationContext context) { 
initMultipartResolver(context); 
initLocaleResolver (context); 
initThemeResolver(context); 
initHandlerMappings(context); 
initHandlerAdapters(context); 
initHandlerExceptionResolvers(context); 
initRequestToViewNameTranslator(context); 
initViewResolvers(context); 
initFlashMapManager (context); 


从 如 上 代码 可 以 看 出 ，DispatcherServlet 启 动 时 会 进行 我 们 需要 的 Web 层 Bean 的 配置 ， 如 
HandlerMapping、HandlerAdapter 等 ， 而 且 如 果 我 们 没有 配置 ， 还 会 给 我 们 提供 默认 的 配 
置 。 


Rte le ， 整 个 DispatcherServlet 初 始 化 的 过 程 和 做 了 些 什么 事情 ， 有 具体 主要 
做 了 如 下 两 件 事情 


1、 初 始 化 Spring Web MVC 使 用 的 Web 上 下 文 ， 并 且 可 能 指定 父 容 器 为 


(ContextLoaderListener 加 载 了 根 上 下 文 ) ; 
2、 初 始 化 DispatcherServlet 使 用 的 策略 ， 如 HandlerMapping、HandlerAdapter 等 。 


服务 器 启动 时 的 日 志 分 析 (此 处 加 上 了 ContextLoaderListener 从 而 启动 ROOT 上 下 文 容 


遇 
MR 


信息 : Initializing Spring root WebApplicationContext // 由 ContextLoaderListener 启 动 ROOT 
上 下 文 


2012-03-12 13:33:55 [main] INFO org.springframework.web.context.ContextLoader - 
Root WebApplicationContext: initialization started 


2012-03-12 13:33:55 [main] INFO 
org.springframework.web.context.support.XmlWebApplicationContext - Refreshing Root 
WebApplicationContext: startup date [Mon Mar 12 13:33:55 CST 2012]; root of context 
hierarchy 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.beans .factory.xml.DefaultBeanDetfinitionDocumentReader - Loading 
bean definitions 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.beans.factory.xml.XmlBeanDetfinitionReader - Loaded 0 bean 
definitions from location pattern [WEB-INF/ContextLoaderListenerxml] 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.web.context.support.XmlWebApplicationContext - Bean factory for 
Root WebApplicationContext: 
org.Sspringframework.beans.factory.support.DefaultListableBeanFactory@1co5ffd: defining 
beans []; root of factory hierarchy 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.web.context.support.XmIWebApplicationContext - Bean factory for 
Root WebApplicationContext: 


2012-03-12 13:33:55 [main] DEBUG org.springframework.web.context.ContextLoader - 
Published root WebApplicationContext as ServletContext attribute with name 
[org.springframework.web.context.WebApplicationContext.ROOT] // 将 ROOT 上 下 文 绑 
定 到 ServletContext 


2012-03-12 13:33:55 [main] INFO org.springframework.web.context.ContextLoader - Root 
WebApplicationContext: initialization completed in 438 ms // 到 此 ROOT 上 下 文 启动 完毕 


2012-03-12 13:33:55 [main] DEBUG org.springframework.web.servlet.DispatcherServlet - 
Initializing servlet 'chapter2' 


信息 : Initializing Spring FrameworkServlet 'chapter2' // 开 始 初始 化 FrameworkServlet 对 应 的 
Web 上 下 文 


2012-03-12 13:33:55 [main] INFO org.springframework.web.servlet.DispatcherServlet - 
FrameworkServlet 'chapter2'": initialization started 


2012-03-12 13:33:55 [main] DEBUG org.springframework.web.servlet.DispatcherServlet - 
Servlet with name 'chapter2' will try to create custom WebApplicationContext context of 
class 'org.springframework.web.context.support.XmlWebApplicationContext, using parent 
context [Root WebApplicationContext: startup date [Mon Mar 12 13:33:55 CST 2012]; 
root of context hierarchy] 


// 此 处 使 用 Root WebApplicationContext 作 为 父 容 器 。 


2012-03-12 13:33:55 [main] INFO 
org.springframework.web.context.support.XmlIWebApplicationContext - Refreshing 
WebApplicationContext for namespace 'chapter2-servlet': startup date [Mon Mar 12 
13:33:55 CST 2012]; parent: Root WebApplicationContext 


2012-03-12 13:33:55 [main] INFO 
org.Sspringframework.beans.factory.xml.XmlBeanDefinitionReader - Loading XML bean 
definitions from ServletContext resource [/WEB-INF/chapter2-servlet.xml] 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.beans .factory.xml.DefaultBeanDefinitionDocumentReader - Loading 
bean definitions 


2012-03-12 13:33:55 [main] DEBUG 

org.springframework.beans .factory.xml.BeanDefinitionParserDelegate - Neither XML 'id' nor 
'name' specified - using generated bean 
name[org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping#0] // 我 
们 配置 的 HandlerMapping 


2012-03-12 13:33:55 [main] DEBUG 

org.springframework.beans .factory.xml.BeanDefinitionParserDelegate - Neither XML 'id' nor 
'name' specified - using generated bean 
name[org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter#0] // 我 们 
配置 的 HandlerAdapter 


2012-03-12 13:33:55 [main] DEBUG 

org.springframework.beans .factory.xml.BeanDefinitionParserDelegate - Neither XML 'id' nor 
'name' specified - using generated bean name 
[org.springframework.web.servlet.view.InternalResourceViewResolver#0] // 我 们 配置 的 
ViewResolver 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.beans .factory.xml.BeanDefinitionParserDelegate - No XML 'id' 
specified - using /hello' as bean name and [] as aliases 


1// 我 们 的 处 理 器 (HelloWorldController) 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.beans.factory.xml.XmlBeanDetfinitionReader - Loaded 4 bean 
definitions from location pattern [WEB-INF/chapter2-servlet.xml] 


2012-03-12 13:33:55 [main] DEBUG 
org.springframework.web.context.support.XmIWebApplicationContext - Bean factory for 
WebApplicationContext for namespace 'chapter2-servlet': 

org.springframework.beans .factory.support.DefaultListableBeanFactory@1372656: defining 
beans 
[org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping#0,org.springframe 


work.web.servlet.mvc.SimpleControllerHandlerAdapter#0,org.springframework.web.servlet.v 
iew.InternalResourceViewResolver#0,/hellol]; parent: 
org.springframework.beans .factory.support.DefaultListableBeanFactory@1c0OS5ffd 


// 到 此 容器 注册 的 Bean 初 始 化 完毕 


2012-03-12 13:33:56 [main] DEBUG org.springframework.web.servlet.DispatcherServlet - 
Unable to locate MultipartResolver with name "multipartResolver: no multipart request 
handling provided 


2012-03-12 13:33:56 [main] DEBUG 
org.springframework.beans .factory.support.DefaultListableBeanFactory - Creating instance 
of bean 'org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver 


// 默 认 的 LocaleResolver 注 册 


2012-03-12 13:33:56 [main] DEBUG 
org.springframework.beans .factory.support.DefaultListableBeanFactory - Creating instance 
of bean 'org.springframework.web.servlet.theme.FixedThemeResolver' 


// 默 认 的 ThemeResolver 注 册 


2012-03-12 13:33:56 [main] DEBUG 

org.springframework.beans .factory.support.DefaultListableBeanFactory - Returning cached 
instance of singleton bean 
'org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping#0" 


/发 现 我 们 定义 的 HandlerMapping 不 再 使 用 默认 的 HandlerMapping。 


2012-03-12 13:33:56 [main] DEBUG 

org.springframework.beans .factory.support.DefaultListableBeanFactory - Returning cached 
instance of singleton bean 
'org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter#0' 


// 发 现 我 们 定义 的 HandlerAdapter 不 再 使 用 默认 的 HandlerAdapter 。 


2012-03-12 13:33:56 [main] DEBUG 

org.springframework.beans .factory.support.DefaultListableBeanFactory - Creating instance 
of bean 
'org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerExceptionResol 


Ver 


/| 异常 处 理解 析 器 ExceptionResolver 


2012-03-12 13:33:56 [main] DEBUG 

org.springframework.beans .factory.support.DefaultListableBeanFactory - Creating instance 
of bean 
'org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerExceptionResol 
Ver 


2012-03-12 13:33:56 [main] DEBUG 
org.Sspringframework.beans.factory.support.DefaultListableBeanFactory - Returning cached 
instance of singleton bean 
'org.springframework.web.servlet.view.InternalResourceViewResolver#0' 


2012-03-12 13:33:56 [main] DEBUG org.springframework.web.servlet.DispatcherServlet - 
Published WebApplicationContext of servlet 'chapter2' as ServletContext attribute with name 
[org.springframework.web.servlet.FrameworkServlet.CONTEXT.chapter2] 


// 绑 定 FrameworkServlet 初 始 化 的 Web 上 下 文 到 ServletContext 


2012-03-12 13:33:56 [main] INFO org.springframework.web.servlet.DispatcherServlet - 
FrameworkServlet 'chapter2'": initialization completed in 297 ms 


2012-03-12 13:33:56 [main] DEBUG org.springframework.web.servlet.DispatcherServlet - 
Servlet 'chapter2' configured successfully 


J// 到 此 完整 流 


捞 
| 
Ee 
A 
中 


从 如 上 日 志 我 们 也 可 以 看 出 ，DispatcherServlet 会 进行 一 些 默 认 的 配置 。 接 下 来 我 们 看 一 下 默 
认 配 置 吧 。 


3.5、DispatcherServlet 默 认 配 置 


DispatcherServlet 的 默认 配置 在 DispatcherServlet.properties (和 DispatcherServlet 类 在 一 个 
包 下 ) 中 ， 而 且 是 当 Spring 配 置 文件 中 没有 指定 配置 时 使 用 的 默认 策略 : 


跟 我 学 Spring 系列 





是 - 久 oré 
日 -SE springframework 
日 web 
-EE servlet 

-Ey config 
由 -E> handl er 
由 -多 > il8n 
HG nve 
BE resource 
Ey support 
办 多 > tags 
-EE thene 
E> view 
DN DispatcherServlet. java 





i DspatcherServlet, propertlies 
nl FlashMap. java 
bs 四 FlashllarMNanager, java 
-一目 PrameworkServlet. java 
j- 四 Hand] erAdsapter .java 
国 HandlerExceptionhesolvyer, ] ava 
Y nl Handl erFxecutionChain java 
> 四 Hasandl erInterceptor. java 
四 Handlerllappine, java 
n HttpServletDean java 
- Dn Local eResolver. java 
Ee 四 WodelAndView. java 
|- 四 ModelAndVi ewDefinineException. java 
四 package™~info. java 
[DN RequestToViewHameTr anslator. java 
bm 四 ResourceServlet, java 
|- 四 SmartView, java 
要 nl ThemeResolver. java 
: 四 View, java 
四 ViewhendererServlet, java 
| 因 Viewhesolver. java 


org.springframework.web.servlet.LocaleResolver=org.springframework.web.servlet.i18n.Acc 
eptHeaderLocaleResolver 


org.springframework.web.servlet. ThemeResolver=org.springframework.web.servlet.theme.F 
ixedThemeResolver 


org.springframework.web.servlet.HandlerMapping=org.springframework.web.servlet.handler. 
BeanNameUrlHandlerMapping,\ 


org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping 
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org.springframework.web.servlet.HandlerAdapter=org.springframework.web.servlet.mvc.Htt 
pRequestHandlerAdapter,\ 


org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter,\ 
org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter 


org.springframework.web.servlet.HandlerExceptionResolver=org.springframework.web.servl 
et.mvc.annotation.AnnotationMethodHandlerExceptionResolver,\ 


org.springframework.web.servlet.mvc.annotation.ResponseStatusExceptionResolver,\ 
org.springframework.web.servlet.mvc.support.DefaultHandlerExceptionResolver 


org.springframework.web.servlet.RequestToViewNameTranslator=org.springframework.web. 
servlet.view.DefaultRequestToViewNameTranslator 


org.springframework.web.servlet.ViewResolver=org.springframework.web.servlet.view.Intern 
alResourceViewResolver 


org.springframework.web.servlet.FlashMapManager=org.springframework.web.servlet.supp 
ort.SessionFlashMapManager 


从 如 上 配置 可 以 看 出 DispatcherServlet 在 启动 时 会 自动 注册 这 些 特殊 的 Bean， 无 需 我 们 注 
册 ， 如 果 我 们 注册 了 ， 默 认 的 将 不 会 注册 。 


此 如 第 二 章 的 BeanNameUrlHandlerMapping、SimpleControllerHandlerAdapter 是 不 需要 
注册 的 ，DispatcherServlet 默 认 会 注册 这 两 个 Bean 。 


从 DispatcherServlet.properties 可 以 看 出 有 许多 特殊 的 Bean， 那 接 下 来 我 们 就 看 看 Spring 
Web MVC 主 要 有 哪些 特殊 的 Bean。 


3.6、DispatcherServlet 中 使 用 的 特殊 的 Bean 


DispatcherServlet 默 认 使 用 WebApplicationContext 作 为 上 下 文 ， 因 此 我 们 来 看 一 下 该 上 下 文 
中 有 哪些 特殊 的 Bean : 


1、Controller : 处 理 器 /页 面 控制 回 ， 做 的 是 MVC 中 的 C 的 事情 ， 但 控制 逻辑 转移 到 前 端 控制 
器 了 ， 用 于 对 请 求 进行 处 理 ; 


2、HandlerMapping : 请 求 到 处 理 器 的 映射 ， 如 果 映 射 成 功 返 回 一 个 HandlerExecutionChain 
对 象 (包含 一 个 Handler 处 理 器 〈 页 面 控制 器 ) 对 象 、 多 个 Handlerlnterceptor 拦 截 器 ) 对 象 ; 
如 BeanNameUrlHandlerMapping 将 URL 与 Bean 名 字 映 射 ， 映 射 成 功 的 Bean 就 是 此 处 的 处 理 


吧 。 
2 ， 


3、HandlerAdapter : HandlerAdapter 将 会 把 处 理 器 包装 为 适配器 ， 从 而 支持 多 种 类 型 的 处 
理 器 ， 即 适配器 设计 模式 的 应 用 ， 从 而 很 容易 支持 很 多 类 型 的 处 理 器 ; 如 
SimpleControllerHandlerAdapter 将 对 实现 了 Controller 接 口 的 Bean 进 行 适 配 ， 并 且 掉 处 理 器 
的 handleRequest 方 法 进行 功能 处 理 ; 


4、ViewResolver : ViewResolver 将 把 逻辑 视图 名 解析 为 具体 的 View， 通 过 这 种 策略 模式 ， 
很 容易 更 换 其 他 视图 技术 ; 如 InternalResourceViewResolver 将 逻辑 视图 名 映射 为 jsp 视 图 ; 


5、LocalResover : 本 地 化 解析 ， 因 为 Spring 支持 国际 化 ， 因 此 LocalResover 解 析 客 户 端的 
Locale 信 息 从 而 方便 进行 国际 化 ; 


6、ThemeResovler : 主题 解析 ， 通 过 它 来 实现 一 个 页 面 多 套 风 格 ， 即 常见 的 类 似 于 软件 皮 
肤 效 果 ; 


7、MultipartResolver : 文件 上 传 解析 ， 用 于 支持 文件 上 传 ; 


8、HandlerExceptionResolver : 处 理 器 异常 解析 ， 可 以 将 异常 映射 到 相应 的 统一 错误 界 
面 ， 从 而 显示 用 户 友 好 的 界面 (而 不 是 给 用 户 看 到 具体 的 错误 信息 ) ; 


9、RequestToViewNameTranslator : 当 处 理 器 没有 返回 逻辑 视图 名 等 相关 信息 时 ， 自 动 将 
请 求 URL 映 射 为 逻辑 视图 名 ; 


10、FlashMapManager : 用 于 管理 FlashMap 的 策略 接口 ，FlashMap 用 于 存储 一 个 请 求 的 输 
出 ， 当 进入 另 一 个 请 求 时 作为 该 请 求 的 输入 ， 通 常用 于 重 定向 场景 ， 后 边 会 细 述 。 


到 此 DispatcherServlet 我 们 已 经 了 解 了 ， 接 下 来 我 们 就 需要 把 上 边 提 到 的 特殊 Bean 挨 个 击 
破 ， 那 首先 从 控制 器 开始 吧 “。 


私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com ) 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/5188.html#16436】 


第 四 章 Controller 接 口 控制 器 详解 (1) 一 一 跟着 
开 涛 学 SpringMVC 


4.1、Controller 简 介 


Controller 控 制 器 ， 是 MVC 中 的 部 分 C， 为 什么 是 部 分 呢 ? 因为 此 处 的 控制 器 主要 负责 功能 处 
理 部 分 


1、 收 集 、 验 证 请 求 参数 并 绑 定 到 命令 对 象 ; 

2、 将 命令 对 象 交 给 业务 对 象 ， 由 业务 对 象 处 理 并 返回 模型 数据 ; 

3、 返 回 ModelAndView (Model 部 分 是 业务 对 象 返回 的 模型 数据 ， 视 图 部 分 为 逻辑 视图 名 ) 。 
还 记得 DispatcherServlet 吗 ? 主要 负责 整体 的 控制 流程 的 调度 部 分 : 

1、 负 责 将 请 求 委 托 给 控制 器 进行 处 理 ; 

2、 根 据 控 制 器 返回 的 逻辑 视图 名 选择 具体 的 视图 进行 泻 染 〈 并 把 模型 数据 传 入 ) 。 

因此 MVC 中 完整 的 C (包含 控制 逻辑 + 功能 处 理 ) 由 (DispatcherServlet + Controller) 组 成 。 
因此 此 处 的 控制 器 是 Web MVC 中 部 分 ， 也 可 以 称 为 页 面 控制 器 、 动 作 、 处 理 器 


Spring Web J 多 种 类 型 的 控制 器 ， 比 如 实现 Controller 接 口 ， 从 Spring2.5 开 始 支持 注 
解 方 式 的 控制 器 (如 @Controller、@RequestMapping、@RequestParam 、 
be ， 我 们 也 可 以 自己 实现 相应 的 控制 器 (只 需要 定义 相应 的 
HandlerMapping 和 HandlerAdapter 即 可 ) 。 


因为 考虑 到 还 有 部 分 公司 使 用 继承 Controller 接 口 实现 方式 ， 因 此 我 们 也 学 习 一 下 ， 虽 然 已 经 

不 推荐 使 用 了 。 

对 于 注解 方式 的 控制 器 ， 后 边 会 详细 讲 ， 在 此 我 们 先 学 习 Spring2.5 以 前 的 Controller 接 口 实现 
并 

首先 我 们 将 项 目 springmvc-chapter2 复 制 一 份 改 为 项 目 springmvc-chapter4， 本 章 示 例 将 放置 

在 springmvc-chapter4 中 。 


大 家 需要 将 项 目 springmvc-chapter4/ .settings/ org.eclipse.wst.common.component 下 的 
chapter2 改 为 chapter4， 否 则 上 下 文 还 是 “springmvc-chapter2”。 以 后 的 每 一 个 章节 都 需要 这 
么 做 。 


4.2、Controller 接 口 


package org.springframework.web,.servlet.mvce; 


public interface Controller { 
ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse respons 
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这 是 控制 器 接口 ， 此 处 只 有 一 个 方法 handleRequest， 用 于 进行 请 求 的 功能 处 理 ， 处 理 完 请 求 
后 返回 ModelAndView (Model 模 型 数据 部 分 和 View 视图 部 分 ) 。 


还 记得 第 二 章 的 HelloWorld 吗 ? 我 们 的 HelloWorldController 实 现 Controller 接 口 ，Spring 默 认 
提供 了 一 些 Controller 接 口 的 实现 以 方便 我 们 使 用 ， 具 体 继 承 体 系 如 图 4-1 : 
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图 4-1 


4.3、WebContentGenerator 

用 于 提供 如 浏览 器 缓存 控制 、 是 否 必须 有 session 开 启 、 支 持 的 请 求 方法 类 型 (GET、POST 
等 ) 等 ， 该 类 主要 有 如 下 属性 : 

Set<String> supportedMethods : 设置 支持 的 请 求 方法 类 型 ， 默 认 支 

持 “GET”"、“POST”*、“HEAD”， 如 果 我 们 想 支持 “PUT”， 则 可 以 加 入 该 集合 “PUT”。 

boolean requireSession = false : 是 否 当 前 请 求 必须 有 session， 如 果 此 属性 为 true， 但 当前 
请 求 没有 打开 session 将 抛 出 HttpSessionRequiredException 弄 常 ; 

boolean useExpiresHeader = true : 是 否 使 用 HTTP1.0 协 议 过 期 响应 头 : 如 果 true 则 会 在 响 
应 头 添加 :“Expires : ”; 需要 配合 cacheSeconds 使 用 ; 


boolean useCacheControlHeader = true : 是 否 使 用 HTTP1.1 协 议 的 缓存 控制 响应 头 ， 如 果 
true 则 会 在 响应 头 添 加 ; 需要 配合 cacheSeconds 使 用 ; 


boolean useCacheControlNoStore = true : 是 否 使 用 HTTP 1.1 协 议 的 缓存 控制 响应 头 ， 如 
果 true 则 会 在 响应 头 添加 ; 需要 配合 cacheSeconds 使 用 ; 


private int cacheSeconds = -1 : 缓存 过 期 时 间 ， 正 数 表示 需要 缓存 ， 负 数 表示 不 做 任何 事 
情 (也 就 是 说 保留 上 次 的 缓存 设置 ) ， 


1、cacheSeconds =0 时 ， 则 将 设置 如 下 响应 头 数据 : 

Pragma : no-cache // HTTP 1.0 的 不 缓存 响应 头 

Expires : 1L // useExpiresHeader=true 时 ，HTTP 1.0 

Cache-Control : no-cache // useCacheControlHeader=true 时 ，HTTP 1.1 

Cache-Control : no-store // useCacheControlNoStore=true 时 ， 该 设置 是 防止 Firefox 绥 存 
2、cacheSeconds>0 时 ， 则 将 设置 如 下 响应 头 数据 : 


Expires : System.currentTimeMillis() + cacheSeconds * 1000L / useExpiresHeader=true 
时 ，HTTP 1.0 


Cache-Control : max-age=cacheSeconds // useCacheControlHeader=true 时 ，HTTP 1.1 
3、cacheSeconds<0 时 ， 则 什么 都 不 设置 ， 即 保留 上 次 的 缓存 设置 。 

此 处 简单 说 一 下 以 上 响应 头 的 作用 ， 缓 存 控制 已 超出 本 书 内 容 : 

HTTP1.0 缓 存 控制 响应 头 

Pragma : no-cache : 表示 防止 客户 端 缓存 ， 需 要 强制 从 服务 器 获取 最 新 的 数据 ; 


Expires : HTTP1.0 响 应 头 ， 本 地 副本 缓存 过 期 时 间 ， 如 果 客 户 端 发 现 缓存 文件 没有 过 期 则 不 
发 送 请 求 ，HTTP 的 日 期 间 必 须 是 格林 威 治 时 间 (GMT) ， 如 “Expires:Wed, 14 Mar 2012 
09:38:32 GMT ” : 


HTTP1.1 缓 存 控制 响应 头 


Cache-Control : no-cache 强制 客户 端 每 次 请 求 获 取 服 务 器 的 最 新 版 本 ， 不 经 过 本 地 缓存 的 副 
本 了 验证; 


Cache-Control : no-store 强 制 客户 端 不 保存 请 求 的 副本 ， 该 设置 是 防止 Firefox 绥 存 


Cache-Control : max-age=[ 秒 ] 客户 端 副本 缓存 的 最 长 时 间 ， 类 似 于 HTTP1.0 的 Expires， 只 
是 此 处 是 基于 请 求 的 相对 时 间 间 隔 来 计算 ， 而 非 绝 对 时 间 。 


还 有 相关 缓存 控制 机 制 如 Last-Modified〈 最 后 修改 时 间 验 证 ， 客 户 端的 上 一 次 请 求 时 间 在 服 
务 器 的 最 后 修改 时 间 之 后 ， 说 明 服 务 器 数据 没有 发 生变 化 返回 304 状 态 码 ) 、ETag (没有 变 
化 时 不 重新 下 载 数 据 ， 返 回 304) 。 


该 抽象 类 默认 被 AbstractController 和 WebContentlnterceptor 继 承 。 


4.4、AbstractController 


该 抽象 类 实现 了 Controller， 并 继承 了 WebContentGenerator ( 具有 该 类 的 特性 ， 有 具体 请 看 
4.3) ， 该 类 有 如 下 属性 


吗 旦 


boolean synchronizeOnSession = false : 表示 该 控制 器 是 否 在 执行 时 同步 session， 从 而 
保证 该 会 话 的 用 户 串 行 访 问 该 控制 器 。 


public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse respons 
// 委 托 给 WMebContentGenerator 进 行 缓存 控制 
EL response, this instanceof LastModified); 
// 当 前 会 话 是 否 应 串 行 化 访问 ， 
if (this.synchronizeOnSession) { 
HttpSession session = request.getSession(false); 
if (session != null) { 
Object mutex = WebUtils.getSessionMutex(session); 
synchronized (mutex) { 
return handleRequestInternal(request, response); 
} 


} 


return handleRequestInternal(request, response); 


} 
男 ES 


可 以 看 出 AbstractController 实 现 了 一 些 特殊 功能 ， 如 继承 了 WebContentGenerator 缓 存 控 制 
功能 ， 并 提供 了 可 选 。 的 串 行 化 访问 功能 。 而 且 提 供 了 handleRequestinternal 方 法 ， 
此 我 们 应 该 在 具体 的 控制 器 类 中 实现 handleRequestlnternal 方 法 ， 而 不 再 是 handleRequest。 





AbstractController 使 用 方法 : 


首先 让 我 们 使 用 AbstractController 来 重 写 第 二 章 的 HelloWorldController : 


public class HelloworldController extends AbstractController { 
Q@Override 
protected ModelAndView handleRequestIinternal(HttpServletRequest req, HttpServletRespo 
//1、 收 集 参数 
//2、 绑 定 参 数 到 命令 对 象 
//3、 调 用 业务 对 象 
//4、 选择 下 一 个 页 面 
ModelAndView mv = new ModelAndView(); 
// 添 加 模型 数据 可 以 是 任意 的 POJO 对 象 
mv.addobject("message", "Hello World!"); 
// 设 置 逻辑 视图 名 ， 视 图 解析 器 会 根据 该 名 字 解 析 到 具体 的 视图 页 面 
mv.setViewName("hello"); 
return mv; 











<! 一 在 chapter4-Sserv1let.xml 配 置 处 理 器 --> 
<bean name="/hello" class="cn.javass.chapter4.web.controller.HelloworldController"/> 


从 如 上 代码 我 们 可 以 看 出 : 
1、 继 承 AbstractController 
2、 实 现 handleRequestlnternal 方 法 即 可 。 
直接 通过 response 写 响应 


如 果 我 们 想 直接 在 控制 器 通过 response 写 出 响应 呢 ， 以 下 代码 帮 我 们 阐述 : 


public class HelloworldwithoutReturnModelAndViewController extends AbstractController { 
Q@Override 


protected ModelAndView handleRequestInternal(HttpServletRequest req, HttpServletRespo 


resp.getwriter().write("Hello World!!" 2 
// 如 果 想 直接 在 该 处 理 器 /控制 器 写 响 应 可 以 通过 返回 null 告 诉 DispatcherServlet 自 己 已 经 写 出 响应 了 : 
return null; 





<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 
<bean name="/hellowithoutReturnModelAndView" class="cn.javass.chapter4.web.controller.Hel 


i 





从 如 上 代码 可 以 看 出 如 果 想 直接 在 控制 器 写 出 响应 ， 只 需要 通过 response 写 出 ， 并 返回 null 即 
可 。 


强制 请 求 方法 类 型 : 


<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 
<bean name="/hellowithPOST" class="cn.javass.chapter4.web.controller.HelloworldController 


<property name="supportedMethods" value="POST"></property> 
</bean> 


到 二 于 王 问 守 





以 上 配置 表示 只 支持 POST 请 求 ， 如 果 是 GET 请 求 客户 端 将 收 到 “HTTP Status 405 - Request 
method 'GET not supported” 


比如 注册 /登录 可 能 只 允许 POST 请 求 。 


当前 请 求 的 Session 前 置 条 件 检 查 ， 如 果 当 前 请 求 无 session 将 抛 出 
HttpSessionRequiredException 措 常 


<! 一 在 chapter4-Sserv1let.xml 配 置 处 理 器 --> 

<bean name="/helloRequireSession" 

class="cn.javass.chapter4.web.controller.HelloworldController"> 
<property name="requireSession" value="true"/> 

</bean> 


在 进入 该 控制 器 时 ， 一 定 要 有 session 存在 ， 否 则 抛 出 HttpSessionRequiredException 异 常 。 


Session 同步 : 


即 同一 会 话 只 能 串 行 访问 该 控制 器 。 


客户 端 端 缓存 控制 : 
1、 缓 存 5 种 ，cacheSeconds=5 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class HelloworldCacheController extends AbstractController { 
@Override 
protected ModelAndView handleRequestIinternal(HttpServletRequest req, HttpServletRespo 


// 点 击 后 再 次 请 求 当前 页 面 
resp.getwriter().write("<a href=''>this</a>"); 
return null; 





<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 

<bean name="/helloCache" 
class="cn.javass.chapter4.web.controller.HelloworldCacheController"> 
<property name="cacheSeconds" value="5"/> 

</bean> 


如 上 配置 表示 告诉 浏览 器 缓存 5 秒 钟 : 


开局 chrome 浏 览 器 调试 工具 : 
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服务 器 返回 的 响应 头 如 下 所 示 : 


this 
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Path Headers Preriew Kesponse Timine 





a A @ > 
Bet | ID@ serints ( 任 Tinnine CY profiles Cits [到 ce。 





BelloCsche Keauest VEEL: http://Yocalhost:9080/sprinaenvc-chapter3/helloCache 
2 g Diar Reauost Wethod; GET 


VReauest Nenders 


Statns Code: @ 200 Ok 


hccept: text/htel, npplication/xhtnlrxnl, application/ xel;q=0.9,+/+;q=0.$ 
ccept~Charset: WTF -5,+ ;aqrg.5 


accept-Incodine: gz-ip, deflate,sdch 


ecopt"Laneuaee: 2h-CN,=h;d=0.3 


Cache-Control: max-nge=0 
Comnection: keep-31ive 
Bost: localhost:9050 


Beferer: http:/ /localhost: 9080/springu,c-chapter3/helloCache 
Vserkeent: MOzilla75.98 (Windows NT 5,1) AppleyebKit/535,11 (KHTHM, like Gecko) Chrome/17,0,963,79 Safari/555,11 


VResponse Nenders 


Cache-Control, wax-age=5 


Content-Leneth: 19 


Bnte: Ued, 14 Mar 2012 09:43:41 GHT 


Expires: Hed, 14 Nar 2012 09:43;46 GYT 


Server: apache-toyote/l. 


添加 了 “Expires:Wed, 14 Mar 2012 09:38:32 GMT” 和 “Cache-Control:max-age=5” 表示 允许 
客户 端 缓 存 5 秒 ， 当 你 点 "this” 链 接 时 ， 会 发 现 如 下 : 


) ml ts $= | 二 
国 Hnint: 贡 | Resouress (eat 内 Seripts rinuine QProfiles uait: [eg censols 


Hame 
Path 


helloCache 
GET 
= /springmve-chapter3 


Nethod 


Status 


Text 
200 
OX 


Type Initiator 


tezt/hinl Other 


Content 
(from cache) 


Time 
Latency 


lBEms 


Ems 


而 且 服 务 器 也 没有 收 到 请 求 ， 当 过 了 5 秒 后 ， 你 再 点 "this" 链 接 会 发 现 又 重新 请 求 服务 器 下 载 新 


数据 。 


吕 己 
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注 : 下 面 提 到 一 些 关于 缓存 控制 的 一 些 特殊 情况 


1、 对 于 一 般 的 页 面 跳 转 (如 超 链接 点 击 跳 转 、 通 过 js 调用 window.open 打 开 新 页 面 都 是 会 使 
用 浏览 器 缓存 的 ， 在 未 过 期 情况 下 会 直接 使 用 浏览 器 缓存 的 副本 ， 在 未 过 期 情况 下 一 次 请 求 


也 不 发 送 ) ; 
2、 对 于 刷新 页 面 (如 按 F5 键 刷新 ) ， 会 再 次 发 送 一 次 请 求 到 服务 器 的 ; 


9 


2、 不 缓存 ，cacheSeconds=0 


<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 
<bean name="/helloNoCache" 


class="cn.javass.chapter4.web.controller.HelloworldCacheController"> 
<property name="cacheSeconds" value="0"/> 
</bean> 


以 上 配置 会 要 求 浏览 器 每 次 都 去 请 求 服务 器 下 载 最 新 的 数据 : 


this 





t 二 到 - 
国 snens I Resources [|@ ies 芝 1 Scripts 导 Timeline ,i Profiles audits Le Console | 
Name 
path Hoeadors Prowin Eosponse Timing 
S| helloNoCache Ecquest VEL: http: 
Boauest Kethod: GET 
Status Code: 200 Ol 


VEequest Headers 


/localhost:9080/sprinemc-chapter3/hellolloCache 


W SOur 
Accept: text /html, application shtmlrxwl, Spplication/xml;d=0,9,*/+*; 09=0.3 
ccept-Charset: UTF -S$,"*;q*0.5 
Accapt—Encoding: g-ip, deflate,sdch 
iccept“Laneuaee: zh-Cll,=h;q=0.5 
Connection: keep-ali\e 
Host; localhost:9080 
Beferer http: /localhost:9880 sp inem/c-chapter3/hellolloCache 
Vser-aeent o-illa/S,@ (Hindows NT 5.1) Applelebl(it /S35.11 (KHTML, like Gecko) Chrome7/17.0.963.79 Safari/535,11 
VEesponse Headers Ice 
Cache-Control: no-cache, no-store 
Content-Leneth: TI 了 
Date: Hed，14 Mar 2612 909:59:535 GMT 
Expires: Thu, O01 Jan 1970 00:00: 00 GHT 
Proarma: no-cache 
Server: Apache-Coyote/1.1 





3、cacheSeconds<0， 将 不 添加 任何 数据 
响应 头 什 么 缓存 控制 信息 也 不 加 。 


4、Last-Modified 缓 存 机 制 


(1、 在 客户 端 第 一 次 输入 url 时 ， 服 务 器 端 会 返回 内 容 和 状态 码 200 表 示 请 求 成 功 并 返回 了 内 
容 ; 同时 会 添加 一 个 “Last-Modified” 的 响应 头 表 示 此 文件 在 服务 器 上 的 最 后 更 新 时 间 ， 


如 “Last-Modified:Wed, 14 Mar 2012 10:22:42 GMT? 表 示 最 后 更 新 时 间 为 (2012-03-14 10 : 
22) ; 


(2、 客 户 端 第 二 次 请 求 此 URL 时 ， 客 户 端 会 向 服务 器 发 送 请 求 头 “上 Modified-Since”， 询 问 
服务 器 该 时 间 之 后 当前 请 求 内 容 是 否 有 被 修改 过 ， 如 “|f-Modified-Since: Wed, 14 Mar 2012 


10:22:42 GMT”， 如 果 服 务 器 端的 内 容 没 有 变化 ， 则 自动 返回 HTTP 304 状 态 码 (只 要 响应 
头 ， 内 容 为 室 ， 这 样 就 节省 了 网 络 带 宽 ) 。 


客户 端 强制 缓存 过 期 : 


(1、 可 以 按 ctrl+F5 强 制 刷 新 (会 添加 请 求 头 HTTP1.0 Pragma:no-cache 和 HTTP1.1 Cache- 
Control:no-cache、If-Modified-Since 请 求 头 被 删除 ) 表示 强制 获取 服务 器 内 容 ， 不 缓存 。 


(2、 在 请 求 的 url 后 边 加 上 时 间 惟 来 重新 获取 内 容 ， 加 上 时 间 惟 后 浏览 器 就 认为 不 是 同一 份 内 


-~ 


容 : 
http://sishuok.com/?2343243243 和 http://sishuok.com/?34334344 是 两 次 不 同 的 请 求 。 


Spring 也 提供 了 Last-Modified 机 制 的 支持 ， 只 需要 实现 LastModified 接 口 ， 如 下 所 示 : 


package cn.javass.chapter4.web.controller; 
public class HelloworldLastModifiedCacheController extends AbstractController implements 
private long lastModified; 
protected ModelAndView handleRequestIinternal(HttpServletRequest req, HttpServletRespo 
// 点 击 后 再 次 请 求 当 前 页 面 
resp.getwriter().write("<a href=''>this</a>"); 
return null; 


public long getLastModified(HttpServletRequest request) { 
if(lastModified == OL) { 
//TODO 此 处 更 新 的 条 件 : 如 果 内 容 有 更 新 ， 应 该 重新 返回 内 容 最 新 修改 的 时 间 戳 
lastModified = System.currentTimeMillis(); 


} 


return lastModified; 





<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 
<bean name="/helloLastModified" 
class="cn.javass.chapter4.web.controller.HelloworldLastModifiedCacheController"/> 


HelloWorldLastModifiedCacheController 只 需要 实现 LastModified 接 口 的 getLastModified 方 
法 ， 保 证 当 内 容 发 生 改 变 时 返回 最 新 的 修改 时 间 即 可 。 


分 析 : 


(1、 发 送 请 求 到 服务 器 ， 如 (http://localhost:9080/springmvc- 
chapter4/helloLastModified) ， 则 服务 器 返回 的 响应 为 : 





区 Elements ( 画 | Resources | (ret | (局 Scripts \ % Timeline Ci Profiles Nauaits Lg consol: 
Hame 
Path Headers Freview Eesponse Timine 





helloLastNoaifiea Eeqaest VBL: http;://localhost:9080/springm/c-chapter3/hellol astModified 
/sprinenve"chapterd Eequest Nethod: GET 
status Code: 200 OK 
YEodnest Hondors 





ccopt: text/html appliicationy xhtml+xal, application/xml;q=0.9,+/+*;q=0.8 

二 ccept~Charset: UTF -3, 0=0.5 

#ccept—Encodine: g-ip, deflate,sdch 

ccept"Laneuaee’: 2h-Cll,2h;q=0.3 

Cache-Control: max-agen 晶 

Connection: keep-alive 

Host: localhost:9080 

Vsorgeont: Mo-illa/S.0 (Windows HT 5.1) AppleUebKit /S35.11 (KHTML, like Gecko) Chrome/17.0.963.79 Safari/S35.11 
VEesponse Headoers iow source 

Contont-Loneth; 19 

Date: Hed, 14 Mar 2012 10:344;29 GMT 

Last-Nodified: led, 14 Mar 2012 10:44:29 GMT 

Server: apache-Coyote/lrl 


(2、 再 次 按 F5 刷 新 客户 端 ， 返 回 状态 码 304 表 示 服 务 器 没有 更 新 过 : 





贺 :sents 加 | Kesources irene 0 Scripts 必 刘 Tineline , Profilas VA Audits Console 


me 
Path Headers Preview Eesponse Timine 


helloLastNodificd Eequest VRL: http://localhost:90850/sprinem cec-chapter3/hellol astModirfied 
jspringn he Eeanest Nethod: GET 

Status Code: @30 Jiot Modifiecd 
VEequest Headers 





tccopt: text/html, application/; xhtml*xnl, application/xul;q"0.9,+/*;q"0.83 

ccept-Charset: UTF-8,*;q=0,5 

ecept—Encodine: g-ip, deflate,sdch 

ccept“Laneuaee: zh-Cl zhiq=0.5 

Cacho-Control:- max-age=Q 

Connection: keep-alive 

Host: localhost:9080 

1f Wodified Since: Hed, 14 Mar 2012 10;44:29 GMT 

Vser-AEent: Mozilla/s. 9 (Windows NT 5.1) AppleNebkit/5355.11 (KHTML, like Gecko) Chrome/17.0.9635,79 Sarfari/535,11 
vEesponse Headers 

Date: Hed, 14 Mar 2012 10:45:34 GMT 

Sarvaor Apache-Coyote/1.1 





(3、 重 启 服 务 器 ， 再 次 刷新 ， 会 看 到 200 状 态 码 (因为 服务 器 的 lastModified 时 间 变 了 ) 。 


Spring 判断 是 否 过 期 ， 通 过 如 下 代码 ， 即 请 求 的 "<f-Modified-Since” 大 于 等 于 当前 的 
getLastModified 方 法 的 时 间 戳 ， 则 认为 没有 修改 : 


this.notModified = (ifModifiedSince >= (lastModifiedTimestamp / 1000 * 1000)); 
5、ETag (实体 标记 ) 缓存 机 制 


(1: 浏览 器 第 一 次 请 求 ， 服 务 器 在 响应 时 给 请 求 URL 标 记 ， 并 在 HTTP 响 应 头 中 将 其 传送 到 


己 


客户 端 ， 类 似 服务 器 端 返 回 的 格式 :“ETag:"0f8b0c86fe2c0c7a67791e53d660208e3” 


(2 :浏览 器 第 二 次 请 求 ， 客 户 端的 查询 更 新 格式 是 这 样 的 : “|f-None- 
Match:"0f8b0c86fe2c0c7a67791e53d660208e3"”"， 如 果 ETag 没 改变 ， 表示 内 容 没 有 发 生 改 
变 ， 则 返回 状态 304。 


Spring 也 提供 了 对 ETag 的 支持 ， 具 体 需 要 在 web.Xxml 中 配置 如 下 代码 : 


<filter> 
<filter-name>etagFilter</filter-name> 
<filter-class>org.springframework.web.filter.ShallowEtagHeaderFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>etagFilter</filter-name> 
<servlet-name>chapter4</servlet-name> 
</filter-mapping> 


过 滤器 只 过 滤 到 我 们 DispatcherServlet 的 请 求 。 


这 


1) :发 送 请 求 到 服务 器 :“http://localhost:9080/springmvc-chapter4/hello”， 服 务 器 返回 的 响 
应 头 中 添加 了 (ETag:"0f8b0c86fe2c0c7a67791e53d660208e3") 





Spring 系列 


1 ~ © 日 
国 swent: 本 | Resources OT 9 Scripts (省 iinain 人 Profiles Caits [yg consols 


Nane 

Path we Headers Preview Eesponse Cookies Timine 

< hello Eequest UEL: http:;//localhost:;9080/springmc-chapter3/hello?1=1 
Eeanest Method: GET 


Statns Code: A 200 Ok 
vEeauost Henders Yiaw source 
ccept: text/htaul, application/xhtnlrxml, application/xnl;q=0.9,*/*;q=0.3 
keenpt-Charset: UTF-8,+;q=0.5 
ccept-Encodine: g-ip, deflate,sdch 
Acecept“Laneuaee: zh-Cll xzh;q=9.5 
Connectiomn: keep-alive 
Cookie: ]SESSIONID=DC0383871715763C26A4E94C538AC9F731 
Host: localhost:90680 
Vser-azent: Mo-illa/S.@ (Hindows IT 5.1) AppleHebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963,.79 Safari/535.11 


VAuory StrinE Paramotars viow URL oncodad 
Ee 入 
VEesponse Headers view SOurce 


Content-Laneuarce; =h-Cll 

Content“Leneth: 266 

Content-Type: text /html;charset=UTF -$8 
Date: Hed, 14 Mar 2012 11:00:29 GMT 

ETaE: "QFSLOCS6fe2cOCc7a67791e53d6602086e3" 
Seryer: Apache-Coyote/1.1 





2) :浏览 器 再 次 发 送 请 求 到 服务 器 ( 按 F5 刷 新 ) ， 请 求 关中 添加 了 “lf-None-Match: 


"Of8b0c86fe2c0c7a67791e53d660208e3'"”， 响 应 返回 304 代 码 ， 表 示 服 务 器 没有 修改 ， 并 且 
响应 头 再 次 添加 了 “ETag:"0f8b0c86fe2c0c7a67791e53d660208e3"” (每 次 都 需要 计算 ) 





\ SS 6= -3 
加 aca: |] Resources | 人 meal 时 Scripts 入 ma (| Profiles a: con:o1e 
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Path . Hender= | Preview Response Cookies 














去 helio Eoauest VEL: http://localhost: 9080/springuvc 
/sprintave-chapter3 Request Nethod: GET 

Status Code: @3504 lot Modified 
VRequest Headers view Source 

ccept: text /html, application/xhtml*xml, application/xml;q"0.9,+/*;q"0.8 

Accept-Charset: YTF -8,+*;49=0.5 

accept-EncodinE: g-ip, deflate,sdch 

ccept~Laneuaee: :zh-Cl, -zhiq=0.5 

Cache-Control: max-age= 合 

Connection: keep-alive 

Cookie: JSESSIONID=DCO887171E 7635C26A4E94C545AC9F 731 

Bost: localhost:9080 

If-Hone-Natch: "Of3bOc56fe2coc7a67791e53d6602038e3" 

Vserkeent: Mozilla/5.© (Windows HT 5,1) appleHebK1it/535,11 (KHTML, like Gecko) Chrome/17.0,.9635,.79 Safari/S535,11 


chapter3/hello?1=1 





vAuery Strine Parameters viaw URL encodeg 
tS 
了 HEesponse Henders VIeW zource 


Date: Wed, 14 Mar 2012 11:03:37 GMT 
ETae: "OfibOoci6fe2zcoc7a67791e53d660208e35” 
Server: Apache-Coyote/1.1 


| eauests 1 1363 transtl 
那 服务 器 端 是 如 何 计 算 ETag 的 呢 ? 


protected String generateETagHeaderValue(byte[] bytes) { 
StringBuilder builder = new StringBuilder("\"0"); 
DigestUtils.appendMd5DigestAsHex(bytes, builder); 
builder.append('"'); 
return builder.toString(); 


bytes 是 response 要 写 回 到 客户 端的 响应 体 ( 即 响 应 的 内 容 数 据 ) ， 是 通过 MD5 算 法 计算 的 内 
容 的 摘要 信息 。 也 就 是 说 如 果 服 务 器 内 容 不 发 生 改 变 ， 则 ETag 每 次 都 是 一 样 的 ， 即 服务 器 端 
的 内 容 没 有 发 生 改 变 。 


此 处 只 列举 了 部 分 缓存 控制 ， 详 细 介 绍 超出 了 本 书 的 范围 ， 强 烈 推 
着 : http://www.mnot.net/cache_docs/ (中 文 
版 http://www.chedong.com/tech/cache_docs.html) 详细 了 解 HTTP 缓 存 控制 及 为 什么 要 
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第 四 章 Controlle 


我 学 Spring 条 


缓存 。 

缓存 的 目的 是 减少 相应 延迟 和 减少 网 络 带 宽 消 耗 ， 比 如 css、js、 图 片 这 类 静态 资源 应 该 进 
行 缓存 。 

实际 项 目 一 般 使 用 反 向 代理 服务 器 (如 nginx、apache 等 ) 进行 缓存 。 

[ 

私 整 在 线 学 习 网 ](http:Wsishuok.comy/) 原 创 内 容 〈[http:/sishuok.com](http:Wsishuok.com/)) 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/0/5234.html]】 


Controller 援 口 控制 驮 伞 解 -一 跟 者 开 涛 学 SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (2) 一 一 跟着 
开 涛 学 SpringMVC 


4.5、ServletForwardingController 


将 接收 到 的 请 求 转发 到 一 个 命名 的 servlet， 具 体 示例 如 下 : 


package cn.javass.chapter4.web.servilet; 

public class ForwardingServlet extends HttpServlet { 
Q@override 
protected void doGet(HttpServletRequest req, HttpServletResponse resp) 
throws ServletException, IOException { 


resp.getwriter().write("Controller forward to Servlet"); 


<servlet> 
<servlet-name>forwarding</servlet-name> 
<servlet-class>cn.javass.chapter4.web.servlet.ForwardingServlet</servlet-class> 


</servlet> 


国生 


<! 一 在 chapter4-Sserv1let.xml 配 置 处 理 器 --> 

<bean name="/forwardToServlet" 

class="org.springframework.web.servlet.mvc.ServletForwardingController"> 
<property name="servletName" value="forwarding"></property> 

</bean> 


当 我 们 请 求 /forwardToServlet 时 ， 会 被 转发 到 名 字 为 “forwarding” 的 servlet 处 理 ， 该 sevlet 的 
servlet-mapping 标 签 配 置 是 可 选 的 。 


4.6、BaseCommandController 


命令 控制 器 通用 基 类 ， 提 供 了 以 下 功能 支持 : 


1、 数 据 绑 定 : 请 求 参 数 绑 定 到 一 个 command object (命令 对 和 象 ， 非 GoF 里 的 命令 设计 模 
式 ) ， 这 里 的 命令 对 象 是 指 绑 定 请 求 参数 的 任何 POJO 对 象 ; 


commandClass : 表示 命令 对 象 实现 类 ， 如 UserModel ; 


commandName : 表示 放 入 请 求 的 命令 对 象 名 字 (上 默认 command) ， 
request.setAttribute(commandName, commandObject); 


2、 验 证 功能 : 提供 Validator 注 册 功 能 ， 注 册 的 验证 器 会 验证 命令 对 象 属 性 数据 是 否 合法 ; 


validators : 通过 该 属性 注入 验证 器 ， 验 证 器 用 来 验证 命令 对 象 属性 是 否 合法 ; 


该 抽象 类 没有 没有 提供 流程 功能 ， 只 是 提供 了 一 些 公共 的 功能 ， 实 际 使 用 时 需要 使 用 它 的 子 


类 。 


4.7、AbstractCommandController 


一 ， 可 以 实现 该 控制 器 来 创建 命令 控制 器 ， 该 控制 器 能 把 自动 封装 请 求 参 数 到 
， 而 且 提 供 了 ee o 


> 
好 
少 
总 
部 从 


1、 创 建 命令 类 (就 是 普通 的 JavaBean 类 /POJO) 


package cn.javass.chapter4.model; 
public class UserModel { 
private String username; 
private String password; 
// 省 略 setter/getter 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class MyAbstractCommandController extends AbstractCcommandController { 
public 人 { 
// 设 置 命令 对 象 实现 类 
setCcommandClass(UserModel .class); 
} 
Q@Override 
protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Objec 
// 将 命令 令 对 象 转换 为 5 实际 类 型 
UserModel user = (UserModel) command ; 
ModelAndView mv = new ModelAndView( ); 
mv.setViewName("abstractCommand"); 
mv.addobject("user", user); 
return mv; 





<! 一 在 chapter4-servlet .xml 配 置 处 理 器 --> 
<bean name="/abstractCommand" 
class="cn.javass.chapter4.web.controller .MyAbstractCommandController"> 


<1-- 也 可 以 通过 依赖 注入 注入 命令 实现 类 --> 
<!-- property name="commandClass" value="cn.javass.chapter4.model.UserModel"/--> 


</bean> 


甫 二 TT 3 G90 


<! 一 WEB-INF/jsp/abstractCcommand.jsp 视 图 下 的 主要 内 容 --> 


${Uuser .username }-${user.password } 


当 我 们 在 浏览 器 中 输入 “http://localhost:9080/springmvc-chapter4/abstractCommand? 
username=123&password=123”， 会 自动 将 请 求 参数 Username 和 password 绑 定 到 命令 对 
象 ; 绑 定 时 按照 JavaBean 命 名 规范 绑 定 ; 


Host: localhost:9080 
Vser-tcent:- Mozilla/5.0 (Windows NT 5.1) Applebebkity535.11 (KHTML, like Gecko) Chrome/17.0.9 


vAauery Strine Parameters view UKISA enco 





conmnmand.setlsernane(™”123™); 
comnmand.setPassword(™"123™); 


msernanme: 123 
password; 123 
vvEResponse Headers view souroce 


Content~Laneuace; zh-Cll 


4.8、AbstractFormController 


用 于 支持 带 步骤 的 表单 提交 的 命令 控制 器 基 类 ， 使 用 该 控制 器 可 以 完成 : 
1、 定 义 表单 处 理 (表单 的 泻 染 ) ， 并 从 控 于 命令 对 象 构建 表单 ; 


提交 表单 处 理 ， 当 用 户 提交 表单 内 容 后 ，AbstractFormController 可 以 将 用 户 请 求 的 数据 乡 
2 命令 对 象 ， 并 可 以 验证 表单 内 容 、 对 命令 对 象 进行 处 理 。 


Q@override 
protected ModelAndView handJleRedquestInternal(HttpServletRequest request, HttpServletR 
throws Exception { 
//1、 是 否 是 表单 提交 ? 该 方法 实现 为 ("POST" .equals(request .getMethod() )) ， 即 POST 表示 表单 提 
If (isFormSubmission(request)) { 
try { 
Object command = getCommand(request); 
ServletRequestDataBinder binder = bindAndValidate(request, command); 
BindException errors = new BindException(binder.getBindingResult()); 
// 表 单 提交 应 该 放 到 该 方法 实现 
return processFormSubmission(request, response, command, errors); 


catch (HttpSessionRequiredException ex) { 
// 省 略 部 分 代码 
return handleInvalidSubmit(request, response); 


} 

} 

else { 
/V/2、 表 示 是 表单 展示 ， 该 方法 又 转调 ShowForm 方 法 ， 因 此 我 们 需要 履 盖 showForm 来 完成 表单 展示 
return showNewForm(request, response); 

} 





bindOnNewForm : 是 否 在 进行 表单 展示 时 绑 定 请 求 参 数 到 表单 对 象 ， 默 认 false， 不 绑 定 ; 


sessionForm : session 表 单 模式 ， 如 果 开 局 (true) 则 会 将 表单 对 象 放置 到 session 中 ， 从 而 
可 以 跨越 多 次 请 求 保证 数据 不 丢失 (多 步骤 表单 常 使 用 该 方式 ， 详 解 
AbstractWizardFormController) ， 默 认 false ; 


Object formBackingObject(HttpServletRequest eduesd : 提供 给 表单 展示 时 使 用 的 表单 
对 象 (form object 表 单 要 展示 的 默认 数据 ) ， 默 认 通 过 commandName 暴 露 到 请 求 给 展示 表 
单 ; 


Map referenceData(HttpServletRequest request, Object command, Errors errors) : 展 
示 表 单 时 需要 的 一 些 引 用 数据 (比如 用 户 注册 ， 可 能 需要 选择 工作 地 点 ， 这 些 数据 可 以 通过 
该 方法 提供 ) ， 如 : 


protected Map referenceData(HttpServletRequest request) throws Exception { 
Map model = new HashMap(); 
model.put("cityList", cityList); 
return model; 


这 样 就 可 以 在 表单 展示 页 面 获取 cityList 数 据 。 


SimpleFormController 继 承 该 类 ， 而 且 提 供 了 更 简单 的 表单 流程 控制 。 


4.9、SimpleFormController 
提供 了 更 好 的 两 步 表 单 支 持 : 

1、 准 备 要 展示 的 数据 ， 并 到 表单 展示 页 面 ; 

2、 提 交 数 据 数 据 进 行 处 理 。 


第 一 步 ， 展 示 : 


HTTP GET 请 求 
ca Eee 
个 





showForm 方 法 





有 






formV 属性 formBackingObject 
指定 视图 页 面 referenceD ata 


第 二 步 ， 提 交 表 单 : 






HTTP POST 请 求 











ongSubmit 方 法 ===» 


doSubmitA ction 方法 


successView 属 性 


指定 视图 页 面 


接 下 来 咱们 写 一 个 用 户 注 册 的 例子 学 习 一 下 : 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class RegisterSimpleFormController extends SimpleFormController { 
public RegisterSimpleFormController() { 
setcommandClass(UserModel.class); // 设 置 命令 对 象 实现 类 
setCommandName("user" ) ;// 设 置 命令 对 象 的 名 字 


} 

//form object 表单 对 象 ， 提 供 展 示 表 单 时 的 表单 数据 〈 使 用 commandName 放 入 请 求 ) 

protected Object formBackingObject(HttpServletRequest request) throws Exception { 
UserModel user = new UserModel(); 
user .setUsername(" 请 输入 用 户 名 ")， 
return user; 


} 

// 提 供 展示 表单 时 需要 的 一 些 其 他 数据 

protected Map referenceData(HttpServletRequest request) throws Exception { 
Map map = new HashMap(); 
map.put("cityList"，Arrays.asList(" 山 东 ",， "北京 "， "上海 ")); 
return map; 


protected void doSubmitAction(Object command) throws Exception { 
UserModel user = (UserModel) command; 
//TODO 调用 业务 对 象 处 理 
System.out.println(user); 


setCommandClass 和 setCommandName : 分 别 设置 了 命令 对 象 的 实现 类 和 名 字 ; 
formBackingObject 和 referenceData : 提供 了 表单 展示 需要 的 视图 ; 


doSubmitAction : 用 于 执行 表单 提交 动作 ， 由 onSubmit 方 法 调用 ， 如 果 不 需 要 请 求 /响应 对 
象 或 进行 数据 验证 ， 可 以 直接 使 用 doSubmitAction 方 法 进行 功能 处 理 。 


(2、spring 瑟 置 (chapter4-servlet.xml ) 


<bean name="/simpleForm" 
class="cn.javass.chapter4.web.controller.RegisterSimpleFormController"> 
<property name="formView" value="register"/> 
<property name="successView" value="redirect:/success"/> 
</bean> 
<bean name="/success" class="cn.javass.chapter4.web.controller.SuccessController"/> 


formView : 表示 展示 表单 时 显示 的 页 面 ; 


successView : 表示 处 理 成 功 时 显示 的 页 面 ; “redirect:/success” 表 示 成 功 处 理 后 重 定向 
到 /success 控 制 器 ; 防止 表单 重复 提交 ; 


“Jsuccess” bean 的 作用 是 显示 成 功 页 面 ， 此 处 就 不 列举 了 。 


(3、 视 图 页 面 


<!1-- register.jsp 注册 展示 页 面 --> 
<form method="post"> 
username:<input type="text" name="username" value="${user.username}"><br/> 
password:<input type="password" name="username"><br/> 
city:<select> 
<c:forEach items="${cityList }" var="city"> 
<option>${city}</option> 
</c:forEach> 
</select><br/> 
<input type="submit" value=" 注 册 "/> 
</form> 


此 处 可 以 使 用 $fuserusername} 获 取 到 formBackingObject 设 置 的 表单 对 象 、 使 用 $fcityLis 廿 获 
取 referenceData 设 置 的 表单 支持 数据 ; 


到 此 一 个 简单 的 两 步 表 单 到 此 结束 ， 但 这 个 表单 有 重复 提交 表单 的 问题 ， 而 且 表 单 对 象 到 页 
面 的 绑 定 是 通过 手工 绑 定 的 ， 后 边 我 们 会 学 习 spring 标 签 库 〈 提 供 自 动 绑 定 表单 对 象 到 页 
面 ) 。 


4.10、CancellableFormController 


一 个 可 取消 的 表单 控制 器 ， 继 承 SimpleFormController， 额 外 提供 取消 表单 功能 。 
1、 表 单 展示 : 和 SimpleFormController 一 样 ; 
2、 表 单 取 消 : 和 SimpleFormController 一 样 ; 


3、 表 单 成 功 提交 : 取消 功能 处 理 方 法 为 : onCancel(Object command)， 而且 默 认 返 回 
cancelView 属 性 指定 的 逻辑 视图 名 。 


那 如 何 判断 是 取消 呢 ? 如 果 请 求 中 有 参数 名 为 " cancep 的 参数 ， 则 表示 表单 取消 。 也 可 以 通 
过 cancelParamKey 来 修改 参数 名 (如 “cancel.x" 等 ) 。 


HTTP POST 请 求 
Pe 有 和 参数 名 为 cancel 
用 户 
Ln 
cancelView 属 性 


指定 视图 页 面 






onCancel 方 法 






复制 RegisterSimpleFormController 一 份 命名 为 CanCancelRegisterSimpleFormController， 添 
加 取消 功能 处 理 方法 实现 : 


Q@override 
protected ModelAndView onCancel(Object command) throws Exception { 
UserModel user = (UserModel) command ; 
//TODO 调用 业务 对 象 处 理 
System.out.println(user); 
return super.onCancel(command); 


onCancel : 在 该 功能 方法 内 实现 取消 逻辑 ， 父 类 的 onCancel 方 法 默认 返回 cancelView 属 性 指 
定 的 逻辑 视图 名 。 


(2、spring 配 置 (chapter4-servlet.xml ) 


<bean name="/canCancelForm" 
class="cn.javass.chapter4.web.controller.CanCancelRegisterSimpleFormController"> 
<property name="formView" value="register"/> 
<property name="successView" value="redirect:/success"/> 
<property name="cancelView" value="redirect:/cancel"/> 
</bean> 
<bean name="/cancel" class="cn.javass.chapter4.web.controller.CancelController"/> 


cancelParamKey : 用 于 判断 是 否 是 取消 的 请 求 参数 名 ， 默 认 是 _cancel， 即 如 果 请 求 参数 数 
据 中 含有 名 字 _cancel 则 表示 是 取消 ， 将 调用 onCancel 功 能 处 理 方法 ; 


cancelView : 表示 取消 时 时 显示 的 页 面 ; “redirect:/cance『 让 表示 成 功 处 理 后 重 定向 到 /cancel 
控制 器 ; 防止 表单 重复 提交 ; 


“cancer bean 的 作用 是 显示 取消 页 面 ， 此 处 就 不 列举 了 ( 详 见 代码 ) 。 


(3、 视 图 页 面 (修改 registerjsp ) 


<input type="submit" name="_cancel" value=" 取 消 "/> 


该 提交 按钮 的 作用 是 取消 ， 因为 name="cance/”， 即 请 求 后 会 有 一 个 名 字 为 _cancel 的 参数 ， 
因此 会 执行 oInCancel 功 能 处 理 方法 。 


(4、 测 试 : 


在 浏览 器 输入 “http://localhost:9080/springmvc-chapter4/canCancelForm”， 则 首先 到 展示 视 
图 页 面 ， 点 击 “ 取 消 按钮 "将 重 定向 到 “http://localhost:9080/springmvc-chapter4/cancel”， 说 明 
取消 成 功 了 。 


实际 项 目 可 能 会 出 现 比 如 一 些 网 站 的 完善 个 人 资料 都 是 多 个 页 面 ( 即 多 步 ) ， 那 应 该 怎么 实 
现 呢 ? 接 下 来 让 我 们 看 一 下 spring Web MVC 提 供 的 对 多 步 表 单 的 支持 类 
AbstractWizardFormController 。 


跟 我 学 Spring 系列 


私 整 在 线 学 习 网 ](http:Wsishuok.comy/) 原 创 内 容 〈[http:/sishuok.com](http:Wsishuok.comy/) ) 


原创 内 容 ， 转 载 请 注 明 私 整 在 线 【http:/sishuok.com/forum/blogPostlist15254.html]】 
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第 四 章 Controller 接 口 控制 器 详解 (3) 一 一 跟着 
开 涛 学 SpringMVC 


4.11、AbstractWizardFormController 


向 导 控 制 器 类 提供 了 多 步骤 (向 导 ) 表单 的 支持 〈 如 完善 个 人 资料 时 分 步骤 填写 基本 信息 、 
工作 信息 、 学 校 信息 等 ) 


假设 现在 做 一 个 完善 个 人 信息 的 功能 ， 分 三 个 页 面 展示 : 
1、 页 面 1 完 善 基本 信息 ; 
3、 页 面 3 完善 工作 信息 。 


这 里 我 们 要 注意 的 是 当 用 户 跳 转 到 页 面 2 时 页 面 1 的 信息 是 需要 保存 起 来 的 ， 还 记得 
AbstractFormController 中 的 sessionForm 吗 ? 如 果 为 true 则 表单 数据 存放 到 Session 中 ， 哈 
哈 ，AbstractWizardFormController 就 是 使 用 了 这 个 特性 。 


乡 定 页 面 ]| 参 数 
InfoFillWizard 
FormController 郑 定 页 面 竣 数 
AS SS 
) ee 绑 定 页 面 郑 数 


命令 对 象 《存放 在 session) 


客户 中 





<property name="pages' 
<list> 
<value >wizard /baseInfo </value> 
<value >wizard /schoolInfo </value> 
<value >wizard /workInfo </wvalue> 
</list> 
< /property > 





向 导 中 的 页 码 从 0 开始 ; 
PARAM_TARGET =" target" : 


选择 向 导 中 的 要 使 用 的 页 面 参数 名 前 级 ， 如 “target0” 则 选择 第 0 个 页 面 显 示 ， 即 图 中 
i ， 以 此 类 推 ， 如 “target1” 将 选择 第 1 页 面 ， 要 得 到 的 页 码 为 去 除 前 
级 “ target 后 的 数字 即 是 ; 


PARAM_FINISH = "_finish”": 


如 果 请 求 参 数 中 有 名 为 " finish” 的 参数 ， 表 示 向 导 成 功 结束 ， 将 会 调用 processFinish 方 法 进行 
完成 时 的 功能 处 理 ; 


PARAM_CANCEL = ”cancel ”: 

如 果 请 求 参数 中 有 名 为 cancel" 的 参数 ， 表 示 向 导 被 取消 ， 将 会 调用 processCance| 方 法 进行 
取消 时 的 功能 处 理 ; 

向 导 中 的 命令 对 象 : 

向 导 中 的 每 一 个 步骤 都 会 把 相关 的 参数 绑 定 到 命令 对 象 ， 该 表单 对 象 默认 放置 在 session 中 ， 
从 而 可 以 跨越 多 次 请 求 得 到 该 命令 对 象 。 

接 下 来 具体 看 一 下 如 何 使 用 吧 。 

(1、 修 改 我 们 的 模型 数据 以 支持 多 步骤 提交 : 


public class UserModel { 

private String username; 

private String password; 

private String realname; // 申 实 姓名 
private WorklnfoModel worklnfo; 
private SchoollnfoModel schoollnfo; 
// 省 略 gettersetter 


} 


public class SchoollnfoModel { 
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private String schoolType; /学 校 类 型 : 高 中 、 中 专 、 大 学 
private String schoolName; // 学 校 名 称 

private String specialty; // 专 业 

// 省略 gettersetter 

} 


Oo 人 PoODPD= 


public class WorklnfoModel { 
private String city; // 所 在 城市 
private String job; // 职 位 
private String year; // 工 作 年 限 
// 省略 gettersetter 

} 


(2、 控 制 器 


OroD= 


1. package cn.javass.chapter4.web.controller; 
2. 1/ 省略 import 
3. public class InfoFillWizardFormController extends AbstractWizardFormController { 


public InfoFillWizardFormController() { 

setCommandClass(UserModel.class); 

setCommandName("user"); 

} 

protected Map referenceData(HttpServletRequest request, int page) throws Exception { 
Map map = new HashMap(); 

if(page==1) { // 如 果 是 填写 学 校 信息 页 需要 学 校 类 型 信息 


. map.put("schoolTypeList", Arrays.a Se 高 中 ", "中 专 ", "大 学 ")); 


} 

if(page==2) {/W/ 如 果 是 填写 工作 信息 页 需要 工作 城市 信息 
map.put("cityList", Arrays.asList(" 济 南 ", "北京 ", "上 海 ")); 

} 

return map; 

} 

protected void validatePage(Object command, Errors errors, int page) { 
// 提 供 每 一 页 数据 的 验证 处 理 方 法 


.} 


. Protected void postProcessPage(HttpServletRequest request, Object command, Errors 


errors, int page) throws Exception { 
// 提 供给 每 一 页 完成 时 的 后 处 理 方法 
} 


. protected ModelAndView processFinish(HttpServletRequest req, HttpServletResponse 


resp, Object command, BindException errors) throws Exception { 


. // 成 功 后 的 处 理 方 法 
. System.out.printIn(command); 
. return new ModelAndView!("redirect:/success"); 


} 


protected ModelAndView processCancel(HttpServletRequest request, 
HttpServletResponse response, Object command, BindException errors) throws 
Exception { 


. // 取 消 后 的 处 理 方 法 

. System.out.printIn(command); 

. return new ModelAndView!("redirect:/cancel"); 
.} 

.} 


page 页 码 : 是 根据 请 求 中 以 “target” 开 头 的 参数 名 来 确定 的 ， 如 target0”， 则 页 码 为 0 ; 


referenceData : 提供 每 一 页 需要 的 表单 支持 对 象 ， 如 完善 学 校 信息 需要 学 校 类 型 ，page 页 码 
从 0 开始 (而 且 根 据 请 求 参数 中 以 “target* 开 头 的 参数 来 确定 当前 页 码 ， 如 _target1， 则 
page=1) ; 


validatePage : 验证 当前 页 的 命令 对 象 数 据 ， 验 证 应 根据 page 页 码 来 分 步骤 验证 ; 
postProcessPage : 验证 成 功 后 的 后 处 理 ; 


processFinish : 成 功 时 执行 的 方法 ， 此 处 直接 重 定向 到 /Success 控制 器 ( 详 见 
CancelController ) ; 


processCancel : 取消 时 执行 的 方法 ， 此 处 直接 重 定向 到 /cancel 控 制 器 ( 详 见 
SuccessController) ; 


其 他 需要 了 解 : 


allowDirtyBack 和 allowDirtyForward : 决定 在 当前 页 面 验证 失败 时 ， 是 否 允 许 向 导 前 移 和 后 
退 ， 默 认 false 不 允许 ; 


onBindAndValidate(HttpServletRequest request, Object command, BindException 
errors, int page) : 允许 覆盖 默认 的 绑 定 参数 到 命令 对 象 和 验证 流程 。 


(3、spring 配 置 文件 (chapter4-servlet.xml) 


. <bean name="/infoFillWizard" 

. Class="cn.javass.chapter4.web.controller.InfoFillWizardFormController"> 
. <property name="pages"> 

. <list> 


. <value>wizard/baselnfo</value> 


. <value>wizard/worklnfo</value> 
. </list> 
.</property> 


1 
2 
3 
4 
5 
6. <value>wizard/schoollnfo</value> 
7 
8 
9 
10. 


</bean> 


pages : 表示 向 导 中 每 一 个 步骤 的 逻辑 视图 名 ， 当 InfoFilWizardFormController 的 page=0， 
则 将 会 选择 “wizard/baselnfo"， 以 此 类 推 ， 从 而 可 以 按 步骤 选择 要 展示 的 视图 。 


(4、 向 导 中 的 每 一 步 视图 
(4.1、 基 本 信息 页 面 (第 一 步 ) baselnfo.jsp : 


<form method="post"> 

揽 实 姓名 :<inputtype="text" name="realname" value="${user.realname}"><br/> 
<input type="submit" name=" target1" value=" 下 一 步 "/> 

</form> 


入 DD 


当前 页 码 为 0 ; 


name=" target1" : 表示 向 导 下 一 步 要 显示 的 页 面 的 页 码 为 1 ; 


(4.2、 学 校 信 息 页 面 (第 二 步 ) schoolinfo.jsp : 


<form method="post"> 

学 校 类 型 : <select name="schoollnfo.schoolType"> 
<c:forEach items="${schoolTypeList }" var="schoolType"> 
<option value="${schoolType )" 

<c:if test="${userschoollnfo.schoolType eq schoolType}"> 
selected="selected" 

</c:if> 

> 
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${schoolType} 


~、 
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</option> 

. </c:forEach> 

12. </select><br/> 

学 校 名 称 : <input type="text" name="schoollnfo.schoolName" 


一 人 
~、 


一 人 
ed 


value="${user.schoollnfo.schoolName}"/><br> 
14. 专业 : <input type="text" name="schoollnfo.specialty" 
value="${user.schoolinfo.specialty}"/><br/> 
15. <input type="submit" name=" target0" value=" 上 一 步 "/> 
16. <input type="submit" name=" target2" value=" 下 一 步 "/> 
17. </form> 


(4.3、 工 作 信息 页 面 (第 三 步 ) worklnfo.jsp : 


<form method="post"> 

所 在 城市 : <select name="worklnfo.city"> 

<c:forEach items="${cityList }" var="city"> 

<option value="${city 六 

<c:if test="${userworklnfo.city eq city}">selected="selected"</c:if> 
> 

${city} 

</option> 

</c:forEach> 

</select><br/> 

. 职位 : <input type="text" name="worklnfo.job" value="${user.worklnfo.job}"/><br/> 
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工作 年 限 : <input type="text" name="worklnfo.year'" value="${user.workInfo.year}"/> 
<br/> 

13. <input type="submit" name=" target1" value=" 上 一 步 "/> 

14. <input type="submit" name=" finish" value=" 完 成 "/> 


15. <input type="submit" name="_cancel" value=" 取 消 "/> 


16. </form> 


当前 页 码 为 2 ; 
name=" target1" : 上 一 步 ， 表示 向 导 上 一 步 要 显示 的 页 面 的 页 码 为 1 ; 
name=" finish" : 向 导 完 成 ， 表 示 向 导 成 功 ， 将 会 调用 向 导 控 制 器 的 processFinish 方 法 ; 


name=" cancel" : 向 导 取 消 ， 表示 向 导 被 取消 ， 将 会 调用 向 导 控 制 器 的 processCancel 方 
法 ; 


到 此 向 导 控 制 器 完成 ， 此 处 的 向 导 流 程 比较 简单 ， 如 果 需 要 更 复杂 的 页 面 流程 控制 ， 可 以 选 
择 使 用 Spring Web Flow 框 架 。 


4.12、ParameterizableViewController 


参数 化 视图 控制 器 ， 不 进行 功能 处 理 ( 即 静态 视图 ) ， 根 据 参数 的 逻辑 视图 名 直接 选择 需要 
展示 的 视图 。 


<bean name="/parameterizableView" 
class="org.springframework.web.servlet.mvc.ParameterizableViewController"> 
<property name="viewName" value="success"/> 

</bean> 


全 DP 


该 控制 器 接收 到 请 求 后 直接 选择 参数 化 的 视图 ， 这 样 的 好 处 是 在 配置 文件 中 配置 ， 从 而 避免 
程序 的 硬 编码 ， 比 如 像 帮助 页 面 等 不 需要 进行 功能 处 理 ， 因 此 直接 使 用 该 控制 器 映射 到 视 
图 o 


4.13、AbstractUrlViewController 
提供 根据 请 求 URL 路 径直 接 转 化 为 逻辑 视图 名 的 支持 基 类 ， 即 不 需要 功能 处 理 ， 直 接 根据 
URL 计 算出 逻辑 视图 名 ， 并 选择 具体 视图 进行 展示 : 


urlDecode : 是 否 进 行 ur| 解 码 ， 不 指定 则 默认 使 用 服务 器 编码 进行 解码 (如 Tomcat 默 认 ISO- 
8859-1) ; 


urlPathHelper : 用 于 解析 请 求 路 径 的 工具 类 ， 默 认为 
org.Springframework.web.util.UrIPathHelper ° 


UrlFilenameViewController 是 它 的 一 个 实现 者 ， 因 此 我 们 应 该 使 用 
UrlFilenameViewController ° 


4.14、UriFilenameViewController 


将 请 求 的 URL 路 径 转 换 为 逻辑 视图 名 并 返回 的 转换 控制 器 ， 即 不 需要 功能 处 理 ， 直 接 根据 
URL 计 算出 逻辑 视图 名 ， 并 选择 具体 视图 进行 展示 : 


根据 请 求 URL 路 径 计算 逻辑 视图 名 ; 


<bean name="/index1/”" 
class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/> 
<bean name="/index2/”**" 
class="org.springframework.web.servlet.mvc.UrIFilenameViewController /> 
<bean name="/*.htmh" 
class="org.springframework.web.servlet.mvc.UrIFilenameViewController /> 
<bean name="/index3/*.html" 
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class="org.springframework.web.servlet.mvc.UrIFilenameViewController /> 


/index1/* : 可 以 匹配 /index1/demo， 但 不 匹配 /index1/demo/demo， 如 /index1/demo 人 逻辑 视图 
名 为 demo ; 


lindex2/ : ** 可 以 匹配 /index2 路 径 下 的 所 有 子路 径 ， 如 匹配 /index2/demo ， 
或 /index2/demo/demo，“/index2/demo” 的 逻辑 视图 名 为 demo， 而 “/index2/demo/demo” 远 辑 
视图 名 为 demo/demo ; 


上 .html : 可 以 匹配 如 /abc.html， 人 逻辑 视图 名 为 abc， 后 级 会 被 删除 (不 仅仅 可 以 是 html) ; 
/lindex3/*.html : 可 以 匹配 /index3/abc.html， 人 逻辑 视图 名 也 是 abc; 
上 述 模式 为 Spring Web MVC 使 用 的 Ant-style 模式 进行 匹配 的 : 


1. ? 匹配 一 个 字符 ， 如 /index? 可 以 匹配 /index1 ， 但 不 能 匹配 /index 或 /index12 


o 匹配 零 个 或 多 个 字符 ， 如 /index1/*， 可 以 匹配 /index1/demo， 但 不 匹 
配 /index1/demo/demo 
3.， 匹配 零 个 或 多 个 路 径 ， 如 /index21/ : 可 以 匹配 /index2 路 径 下 的 所 有 子路 径 ， 如 匹 
配 /index2/demo， 或 /index2/demo/demo 


4.， 如 果 我 有 如 下 模式 ， 那 Spring 该 选择 哪 一 个 执行 呢 ? 当 我 的 请 求 为 /long/long” 时 如 下 所 
示 : 


/long/long 

/long/**/abc 

/long/** 

ji 

Spring 的 AbstractUrlHandlerMapping 使 用 : 最 长 匹配 优先 ; 

10. 如 请 求 为 %long/long” 将 匹配 第 一 个 %long/long”， 但 请 求 %long/acd” 则 将 匹配 4%long/”， 如 
请 求 “/long/aa/labc” 则 匹配 “/long//abc”， 如 请 求 /abc” 则 将 匹配 “1**” 
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UrlIFilenameViewController 还 提供 了 如 下 属性 : 
prefix : 生成 逻辑 视图 名 的 前 级 ; 
suffix : 生成 逻辑 视图 名 的 后 级 ; 


1. protected String postProcessViewName(String viewName) { 
2. return getPrefix() + viewName + getSuffix(); 
3. } 


1. <bean name="/*.htm" 
class="org.springframework.web.servlet.mvc.UrlFilenameViewController"> 

2. <property name="prefix" value="test"/> 

3. <property name="suffix" value="test"/> 

4. </bean> 


当 prefix="test”，suffix="“test”， 如 上 所 示 的 /*.htm : 可 以 匹配 如 /abc.htm， 但 逻辑 视图 名 将 
变 为 testabctest。 


私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com ) 


原创 内 容 ， 转 载 请 注 明 私 部 在 线 【http://sishuok.com/forum/blogPost/list/5254.html]】 
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4.12、ParameterizableViewController 


参数 化 视图 控制 器 ， 不 进行 功能 处 理 ( 即 静态 视图 ) ， 根 据 参 数 的 逻辑 视图 名 直接 选择 需要 
展示 的 视图 。 


<bean name="/parameterizableView" 
class="org.springframework.web.servlet.mvc.ParameterizableViewController "> 
<property name="viewName" value="success"/> 

</bean> 


DD 


该 控制 器 接收 到 请 求 后 直接 选择 参数 化 的 视图 ， 这 样 的 好 处 是 在 配置 文件 中 配置 ， 从 而 避免 
程序 的 硬 编码 ， 比 如 像 帮助 页 面 等 不 需要 进行 功能 处 理 ， 因 此 直接 使 用 该 控制 器 映射 到 视 
图 。 


4.13、AbstractUrlViewController 
提供 根据 请 求 URL 路 径直 接 转 化 为 逻辑 视图 名 的 支持 基 类 ， 即 不 需要 功能 处 理 ， 直 接 根据 
URL 计 算出 逻辑 视图 名 ， 并 选择 具体 视图 进行 展示 : 


urlDecode : jUrl 解 码 ， 不 指定 则 默认 使 用 服务 器 编码 进行 解码 (如 Tomcat 上 默认 ISO- 
8859-1) ; 


urlPathHelper : 用 于 解析 请 求 路 径 的 工具 类 ， 默 认为 
org.springframework.web.util.UrliPathHelper 。 


UrlFilenameViewController 是 它 的 一 个 实现 者 ， 因 此 我 们 应 该 使 用 
UrlFilenameViewController ° 


4.14 、UrlFilenameViewController 

将 请 求 的 URL 路 径 转 换 为 逻辑 视图 名 并 返回 的 转换 控制 器 ， 即 不 需要 功能 处 理 ， 直 接 根据 
URL 计 算出 逻辑 视图 名 ， 并 选择 具体 视图 进行 展示 : 

根据 请 求 URL 路 径 计 算 逻 辑 视图 名 ; 


1. <bean name="/index1/*" 
2. class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/> 
3. <bean name="/index2/**" 


class="org.springframework.web.servlet.mvc.UrIFilenameViewController /> 
<bean name="/*.htmh" 
class="org.springframework.web.servlet.mvc.UrIFilenameViewController /> 
<bean name="/index3/*.html" 


ON 


class="org.springframework.web.servlet.mvc.UrlFilenameViewController"/> 


/index1/* : 可 以 匹配 /index1/demo， 但 不 匹配 /index1/demo/demo， 如 /index1/demo 人 逻辑 视图 
名 为 demo ; 


/index2/ : 六 可 以 匹配 /index2 路 径 下 的 所 有 子路 径 ， 如 匹配 /index2/demo， 
或 /index2/demo/demo，%windex2/demo" 的 逻辑 视图 名 为 demo， 而 %index2/demo/demo” 逮 辑 
视图 名 为 demo/demo ; 


上 .html : 可 以 匹配 如 /abc.html， 人 逻辑 视图 名 为 abc， 后 级 会 被 删除 (不 仅仅 可 以 是 html) ; 
/lindex3/*.html : 可 以 匹配 /index3/abc.html， 人 逻辑 视图 名 也 是 abc; 
上 述 模式 为 Spring Web MVC 使 用 的 Ant-style 模式 进行 匹配 的 : 


1. ? 匹配 一 个 字符 ， 如 /index? 可 以 匹配 /index1 ， 但 不 能 匹配 /index 或 /index12 


o 匹配 零 个 或 多 个 字符 ， 如 /index1/#*， 可 以 匹配 /index1/demo， 但 不 匹 
配 /index1/demo/demo 
3. 匹配 零 个 或 多 个 路 径 ， 如 /index21/ : 可 以 匹配 /index2 路 径 下 的 所 有 子路 径 ， 如 匹 
配 /index2/demo， 或 /index2/demo/demo 


4.， 如 果 我 有 如 下 模式 ， 那 Spring 该 选择 哪 一 个 执行 呢 ? 当 我 的 请 求 为 /long/long” 时 如 下 所 


示 : 


/long/long 

/long/**/abc 

/long/** 

ji 

Spring 的 AbstractUrlHandlerMapping 使 用 : 最 长 匹配 优先 ; 

10. 如 请 求 为 %long/long” 将 匹配 第 一 个 %long/long”， 但 请 求 %long/acd” 则 将 匹配 4%long/”， 如 
请 求 “/long/aa/labc” 则 匹配 /long//abc”， 如 请 求 /abc” 则 将 匹配 “1**” 


© PN 


UrlFilenameViewController 还 提供 了 如 下 属性 
prefix : 生成 逻辑 视图 名 的 前 级 ; 
suffix : 生成 逻辑 视图 名 的 后 组 ; 


1. protected String postProcessViewName(String viewName) { 
2. return getPrefix() + viewName + getSuffix(); 
3. } 


1. <bean name="/*.htm" 
class="org.springframework.web.servlet.mvc.UrlFilenameViewController"> 


2. <property name="prefix" value="test"/> 

3. <property name="suffix" value="test"/> 

4. </bean> 

当 prefix='test”，suffix="“test”， 如 上 所 示 的 /*.htm : 可 以 匹配 如 /abc.htm， 但 逻辑 视图 名 将 
变 为 testabctest 。 

私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com) 

原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/5498.html]】 


第 四 章 Controller 接 口 控制 器 详解 (5) 一 一 跟着 
开 涛 学 SpringMVC 


原创 内 容 ， 转 载 请 注 明 iteye 
http://jinnianshilongnian.iteye.com/ 


4.15、MultiActionController 


之 前 学 过 的 控制 器 如 AbstractCommandController、SimpleFormController 等 一 般 对 应 一 个 功 
能 处 理 方法 〈 如 新 增 ) ， 如 果 我 要 实现 比如 最 简单 的 用 户 增删 改 查 〈CRUD Create-Read- 
Update-Delete) ， 那 该 怎么 办 呢 ? 

4.15.1 解决 方案 

1、 每 一 个 功能 对 应 一 个 控制 器 ， 如 果 是 CRUD 则 需要 四 个 控制 器 ， 但 这 样 我 们 的 控制 器 会 暴 
增 ， 肯 定 不 可 取 ; 

2、 使 用 Spring Web MVC 提 供 的 MultiActionController， 用 于 支持 在 一 个 控制 器 里 添加 多 个 功 
能 处 理 方法 ， 即 将 多 个 请 求 的 处 理 方 法 放置 到 一 个 控制 器 里 ， 这 种 方式 不 错 。 

4.15.2 问题 

1、 MultiActionController 如 何 将 不 同 的 请 求 映 射 不 同 的 请 求 的 功能 处 理 方法 呢 ? 


Spring Web MVC 提 供 了 MethodNameResolver (方法 名 解析 器 ) 用 于 解析 当前 请 求 到 需要 执 
行 的 功能 处 理 方法 的 方法 名 。 默 认 使 用 InternalPathMethodNameResolver 实 现 类 ， 另 外 还 提 
供 了 ParameterMethodNameResolver 和 PropertiesMethodNameResolver， 当 然 我 们 也 可 以 
自己 来 实现 ， 稍 候 我 们 仔细 研究 下 它们 是 如 何 工作 的 。 


2、 那 我 们 的 功能 处 理 方法 应 该 怎么 写 呢 ? 


public (ModelAndView | Map | String | void) actionName(HttpServletRequest request, 
HttpServletResponse response, [,HttpSession session] [,AnyObject]); 


哦 ， 原 来 如 此 ， 我 们 只 需要 按照 如 上 格式 写 我 们 的 功能 处 理 方 法 即 可 ; 此 处 需要 注意 一 下 几 
起 


1、 返 回 值 : 即 模型 和 视图 部 分 ; 


ModelAndView : 模型 和 视图 部 分 ， 之 前 已 经 见 过 了 ; 


Map : 只 返回 模型 数据 ， 逮 辑 视图 名 会 根据 RequestToViewNameTranslator 实 现 类 来 计算 ， 
稍 候 讨论 ; 


String : 只 返回 逻辑 视图 名 ，; 


void : 表示 该 功能 方法 直接 写 出 response 响 应 (如果 其 他 返回 值 类 型 (如 Map) 返回 null 则 和 
void 进 行 相同 的 处 理 ) ; 


2、actionName : 功能 方法 名 字 ; 由 methodNameResolver 根 据 请 求 信 息 解 析 功 能 方法 名 ， 
通过 反射 调用 ; 


3、 形 参 列 表 : 顺序 固定 ，“[]" 表 示 可 选 ， 我 们 来 看 看 几 个 示例 吧 

// 表 示 到 新 增 页 面 

public ModelAndView toAdd(HttpServletRequest request, HttpServletResponse response); 
/1 表示 新 增 表 单 提 交 ， 在 最 后 可 以 带 着 命令 对 象 


public ModelAndView add(HttpServletRequest request, HttpServletResponse response， 
UserModel user); 


/1 列表 ， 但 只 返回 模型 数据 ， 视 图 名 会 通过 RequestToViewNameTranslator 实 现 来 计算 
public Map list(HttpServletRequest request, HttpServletResponse response); 
// 文 件 下 载 ， 返 回 值 类 型 为 void， 表 示 该 功能 方法 直接 写 响应 

public void fileDownload(HttpServletRequest request, HttpServletResponse response) 
// 第 三 个 参数 可 以 是 session 


public ModelAndView sessionWith(HttpServletRequest request, HttpServletResponse 
response, HttpSession session); 


/如果 第 三 个 参数 是 Session， 那 么 第 四 个 可 以 是 命令 对 象 ， 顺 序 必 须 是 如 下 顺序 


public void sessionAndCommandWith(HttpServletRequest request, HttpServletResponse 
response, HttpSession session, UserModel user) 


4、 异 常 处 理 方法 ，MultiActionController 提 供 了 简单 的 异常 处 理 ， 即 在 请 求 的 功能 处 理 过 程 中 
遇 到 异常 会 交 给 异常 处 理 方 法 进行 处 理 ， 式 如 下 所 示 : 


public ModelAndView anyMeaningfulIName(HttpServletRequest request, 
HttpServletResponse response, ExceptionClass exception) 


MultiActionController 会 使 用 最 接近 的 异常 类 型 来 匹配 对 应 的 异常 处 理 方 法 ， 示 例如 下 所 示 : 


/| 处理 PayException 


public ModelAndView processPayException(HttpServletRequest request, 
HttpServletResponse response, PayException ex) 


1/ 处理 Exception 


public ModelAndView processException(HttpServletRequest request, HttpServletResponse 
response, Exception ex) 


4.15.3 MultiActionController 类 实现 


类 定义 : public class MultiActionController extends AbstractController implements 
LastModified ， 继 承 了 AbstractController， 并 实现 了 LastModified 接 口 ， 上 默认 返回 -1 ; 


核心 属性 : 
delegate : 功能 处 理 的 委托 对 象 ， 即 我 们 要 调用 请 求 处 理 方法 所 在 的 对 象 ， 默 认 是 this ; 


methodNameResolver : 功能 处 理 方法 名 解析 器 ， 即 根据 请 求 信息 来 解析 需要 执行 的 
delegate 的 功能 处 理 方法 的 方法 名 。 


核心 方法 : 


// 判 断 方法 是 否 是 功能 处 理 方法 
private boolean isHandlerMethod(Method method) { 
// 得 到 方法 返回 值 类 型 
Class returnType = method.getReturnType(); 
// 返 回 值 类 型 必须 是 ModelAndView、Map、String、void 中 的 一 种 ， 否 则 不 是 功能 处 理 方法 
If (ModelAndView.class.equals(returnType) || Map.class.equals(returnType) || String.c 
void.class.equals(returnType)) { 
Class[] parameterTypes = method.getParameterTypes(); 
// 功 能 处 理 方法 参数 个 数 必须 >=2， 且 第 一 个 是 HttpServletRequest 类 型 、 第 二 个 是 HttpServletRespol 
// 且 不 能 Controller 接 口 的 handleRequest(HttpServletRequest request, HttpServletRespon 
return (parameterTypes. Jength >= 2 && 
HttpServletRequest.class.equals(parameterTypes[0]) && 
HttpServletResponse.class.equals(parameterTypes[1]) && 
!("handleRequest".equals(method.getName()) && parameterTypes.length == 2) 


return false; 


} 
| 





// 是 否 是 异常 处 理 方法 
private boolean isExceptionHandlerMethod(Method method) { 
// 蜡 常 处 理 方法 必须 是 功能 处 理 方法 且 参数 长 度 为 3、 第 三 个 参数 类 型 是 Throwable 子 类 
return (isHandlerMethod(method) && 
method .getParameterTypes(). Length == 3 && 
Throwable.class.isAssignableFrom(method.getParameterTypes()[2])); 


private void registerHandlerMethods(Object delegate) { 
// 缓 存 Map 清 空 
this.handlerMethodMap.clear(); 
this.lastModifiedMethodMap.clear(); 
this.exceptionHandlerMap.clear(); 


// 得 到 委托 对 象 的 所 有 public 方 法 
Method[] methods = delegate.getcClass().getMethods(); 
for (Method method : methods) { 
// 验 证 是 否 是 异常 处 理 方法 ， 如 果 是 放 入 exceptionHandlerMap 缓 存 map 
if (isExceptionHandlerMethod(method)) { 
registerExceptionHandlerMethod(method); 


// 验 证 是 否 是 功能 处 理 方法 ， 如 果 是 放 入 handlerMethodMap 缕 存 map 

else if (isHandlerMethod(method)) { 
registerHandlerMethod(method); 
registerLastModifiedMethodIfExists(delegate, method); 


protected ModelAndView handleRequestIinternal(HttpServletRequest request, HttpServletRespo 
throws Exception { 
try { 
//1、 使 用 methodNameResolver 方法 名 解析 器 根据 请 求解 析 到 要 执行 的 功能 方法 的 方法 名 
String methodName = this.methodNameResolver .getHandlerMethodName(request); 
//2、 调 用 功能 方法 (通过 反射 调用 ， 此 处 就 粘贴 代码 了 ) 
return invokeNamedMethod(methodName, request, response); 


catch (NoSuchRequestHandlingMethodException ex) { 
return handleNoSuchRequestHandlingMethod(ex, request, response); 





接 下 来 ， 我 们 看 一 下 MultiActionController 如 何 使 
用 MethodNameResolver 来 解析 请 求 到 功能 处 理 方法 的 方法 名 。 


4.15.4 MethodNameResolver 
*x*1、InternalPathMethodNameResolver : **` “MultiActionController 的 默认 实现 ， 提 供 从 请 求 URL 路 径 解 析 开 
**2、ParameterMethodNameResolver : **`` 提 供 从 请 求 参 数 解 析 功 能 处 理 方 法 的 方法 名 ， 并 按照 如 下 顺序 进行 解析 : 


(1、“`methodParamNames : ` 根 据 请 求 的 参数 名 解析 功能 方法 名 (功能 方法 名 和 参数 名 同名 ) ; 


<property name="methodPparamNames" value="list,create,update"/> 
如 上 配置 时 ， 如 果 请 求 中 含有 参数 名 1ist、create、update 时 ， 则 功能 处 理 方法 名 为 list、create、update， 这 种 方 


ParameterMethodNameResolver 也 考虑 到 图 片 提交 按钮 提交 问题 : 


&lt;input type="image" name="list"&gt; 和 submit 类 似 可 以 提交 表单 ， 单 击 该 图 片 后 会 发 送 两 个 参数 “]ist .x 


for (String suffix : SUBMIT_IMAGE_SUFFIXES) {//SUBMIT_IMAGE_ SUFFIXES {”.x”, “.y”} 
If (request.getParameter(name + suffix) != null) {// name 是 我 们 配置 的 methodparamNames 
return true; 
} 
} 
了 ja 


(2、paramName :“ “根据 请 求 参数 名 的 值 解析 功能 方法 名 ， 默 认 的 参数 名 是 action， 即 请 求 的 参数 中 含有 “action=qut 








(3、logicalMappings :`` 逻 辑 功 能 方法 名 到 监 实 功能 方法 名 映射 ， 如 下 所 示 : 


<property name="logicalMappings"> 
<props> 
<prop key="doList">list</prop> 
</props> 
</property> 


即 如 果 步 又 1 或 2 解析 出 逻辑 功能 方法 名 为 doList (逻辑 的 ) ， 将 会 被 重新 映射 为 list 功 能 方法 名 ( 丨 正 执行 的 ) 。 
(4、defaultMethodName : 默认 的 方法 名 ， 当 以 上 策略 失败 时 默认 调用 的 方法 名 。 


**3、PropertiesMethodNameResolver : ** 提供 自 定义 的 从 请 求 URL 解 析 功 能 方法 的 方法 名 ， 使 用 一 组 用 户 自 定义 t 
Properties 对 象 存放 ， 具 体 配 置 示 例如 下 : 


<bean id="propertiesMethodNameResolver" 
class="org.springframework.web.servlet.mvc.multiaction.PropertiesMethodNameResolver"> 
<property name="mappings"> 
<props> 
<prop key="/create">create</prop> 
<prop key="/update">update</prop> 
<prop key="/delete">delete</prop> 
<prop key="/list">list</prop> 
二 全 默认 的 行为 ”==> 
<prop key="/**">list</prop> 
</props> 
</property> 
</bean> 


对 于 /create 请 求 将 调用 Create 方法 ，Spring 内 部 使 用 PathMatcher 进 行 匹 配 (默认 实现 是 AntPathMatcher) 。 


4.15.5 RequestToViewNameTranslator 


用 于 直接 将 请 求 转换 为 逻辑 视图 名 。 默 认 实 现 为 DefaultRequestToViewNameTranslator° 


**1、DefaultRequestToViewNameTranslator : **、` 将 请 求 URL 转 换 为 逻辑 视图 名 ， 默 认 规 则 如 下 : 


http://localhost:9080/web 上 下 文 /list ------- &gt; 逻辑 视图 名 为 ]ist 
http://localhost:9080/web 上 下 文 /list.html ------- &gt; 逻辑 视图 名 为 list (默认 删除 扩展 名 】 
http://localhost:9080/web 上 下 文 /user/list.html ------- &gt; 逻辑 视图 名 为 user/list 


4.15.6 示例 


** (14、 控 制 器 UserController** 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class UserController extends MultiActionController { 
// 用 户 服务 类 
private UserService userService,; 
// 逻 辑 视图 名 通过 依赖 注入 方式 注入 ， 可 配置 
private String createView; 
private String updateView; 
private String deleteView; 
private String listView; 
private String redirectToListView; 
// 省 略 setter/getter 


public String create(HttpServletRequest request, HttpServletResponse response, UserMo 
if("GET".equals(request.getMethod())) { 
// 如 果 是 get 请 求 我 们 转向 新 增 页 面 
return getCreateView( ); 
} 
userService.create(user); 
// 直 接 重 定向 到 列表 页 面 
return getRedirectToListView() ; 





public ModelAndView update(HttpServletRequest request, HttpServletResponse response, 
if("GET".equals(request.getMethod())) { 
// 如 果 是 get 请 求 我 们 转向 更 新 页 面 
ModelAndView mv = new ModelAndView( ); 
// 查 询 要 更 新 的 数据 
mv.addobject("command", userService.get(user.getUsername())); 
mv.setViewName(getUpdateView!( )); 
return mv; 
} 
userService.update(user); 
// 直 接 重 定向 到 列表 页 面 
return new ModelAndView(getRedirectToListView()); 


} 


public ModelAndView delete(HttpServletRequest request, HttpServletResponse response, 
if("GET".equals(request.getMethod())) { 
// 如 果 是 get 请 求 我 们 转向 删除 页 面 
ModelAndView mv = new ModelAndView( ); 
// 查 询 要 删除 的 数据 
mv.addobject("command", userService.get(user.getUsername())); 
mv.setViewName(getDeleteView( ) ) ; 
return mv; 
} 
userService.delete(user); 
// 直 接 重 定向 到 列表 页 面 
return new ModelAndView(getRedirectToListView()); 


} 


public ModelAndView list(HttpServletRequest request, HttpServletResponse response) { 
ModelAndView mv = new ModelAndView( ); 
mv.addobject("userList", userService.1list()); 
mv.setViewName(getListView!( )); 
return mv; 


} 


// 如 果 使 用 委托 方式 ， 命 令 对 象 名 称 只 能 是 command 

protected String getCommandName(Object command ) { 
// 命 令 对 象 的 名 字 默认 command 
return "command"; 





增删 改 : 如 果 是 GET 请 求 方法 ， 则 表示 到 展示 页 面 ，POST 请 求 方法 表示 扶正 的 功能 操作 ; 


** getCommandName : ** 表示 是 命令 对 象 名 字 ， 默 认 command， 对 于 委托 对 象 实现 方式 无 法 改 
变 ， 因 此 我 们 就 使 用 默认 的 吧 。 


** (2、spring 配 置 文件 chapter4-servlet.xml** 


<bean id="userService" class="cn.javass.chapter4.service.UserService"/> 
<bean name="/user/**" class="cn.javass.chapter4.web.controller.UserController"> 
<property name="userService" ref="userService"/> 
<property name="createView" value="user/create"/> 
<property name="updateView" value="user/update"/> 
<property name="deleteView" value="user/delete"/> 
<property name="]listView" value="user/list"/> 
<property name="redirectToListView" value="redirect:/user/list"/> 
<1-- 使 用 PropertiesMethodNameResolver 来 解析 功能 处 理 方法 名 --> 
<!--property name="methodNameResolver" ref="propertiesMethodNameResolver"/--> 
</bean> 


**USerService : ** 用 户 服务 类 ， 实 现 业务 逻辑 ; 

** 依赖 注入 : ** 对 于 逻辑 视图 页 面 通过 依赖 注入 方式 注入 ，redirectToListView 表 示 增 删改 成 功 后 重 定向 的 页 面 ， 防 . 
** 默认 使 用 InternalPathMethodNameResolver 解 析 请 求 URL 到 功能 方法 名 。** 

** (3、 视 图 页 面 ** 


** (3.1、1list 页 面 (WEB-INF/jsp/user/list.jsp) ** 


<a href="${pageContext.request.contextPath}/user/create"> 用 户 新 增 </a><br/> 
<table border="1" width="50%"> 
<tr> 
<th> 用 户 名 </th> 
<th> 瘟 实 姓 名 </th> 
<th> 操 作 </th> 
</tr> 
<c:forEach items="${userList}" var="user"> 
<tr> 
<td>${user .username }</td> 
<td>${user .realname }</td> 
<td> 
<a href="${pageContext.request,.contextPath}/user/update?username=${user .usernam 
| 
<a href="${pageContext.request.contextPpath}/user/delete?username=${user .usernam 
</td> 
</tr> 
</c:forEach> 
</table> 


RE 


** (3.2、update 页 面 (WEB-INF/jsp/user/update.jsp) ** 





<form action="${pageContext.request.contextPath}/user/update" method="post"> 

用 户 名 : <input type="text" name="username" value="${command.username}"/><br/> 
真实 姓名 : <input type="text" name="realname" value="${command.realname}"/><br/> 
<input type="submit" value=" 更 新 "/> 

</form> 


xx (4、 测 试 : ** 


默认 的 InternalPathMethodqNameResolver 将 进行 如 下 解析 : 


http://localhost:9080/springmvc-chapter4/user/list 一 一 一 一 >list 方 法 名 ; 


http://localhost:9080/springmvc-chapter4/user/create 一 一 >create 方 法 名 ; 
http://localhost:9080/springmvc-chapter4/user/update 一 一 一 一 >update 功 能 处 理 方法 名 ; 
http://localhost:9080/springmvc-chapter4/user/delete 一 一 一 >delete 功 能 处 理 方 法 名 。 


我 们 可 以 将 默认 的 InternalPathMethodNameResolver 改 为 
PropertiesMethodNameResolver : 


<bean id="propertiesMethodNameResolver" 
class="org.springframework .web.servlet.mvc.multiaction.PropertiesMethodNameResolver"> 
<property name="mappings"> 
<props> 
<prop key="/user/create">create</prop> 
<prop key="/user/update">update</prop> 
<prop key="/user/delete">delete</prop> 
<prop key="/user/list">list</prop> 
<prop key="/**">list</prop><!-- 默认 的 行为 --> 
</props> 
</property> 
<property name="alwaysUseFullPath" value="false"/><!-- 不 使 用 全 路 径 --> 
</bean> 
<bean name="/user/**" class="cn.javass.chapter4.web.controller .UserController"> 
<1 一 省 略 其 他 配置 ， 详 见 配置 文件 - -> 
<1-- 使 用 PropertiesMethodNameResolver 来 解析 功能 处 理 方法 名 --> 
<property name="methodNameResolver" ref="propertiesMethodNameResolver"/> 
</bean> 


/表示 上 默认 解析 到 list 功 能 处 理 方法 。* 


如 上 配置 方式 可 以 很 好 的 工作 ， 但 必须 继承 MultiActionController，Spring Web MVC 提 供给 我 
们 无 需 继承 MultiActionController 实 现 方式 ， 即 使 有 委托 对 象 方式 ， 继 续 往 下 看 吧 。 


条 by 了 /> 
4.15.7、 委 托 方式 实现 
** (1、 控 制 器 UserDelegate** 
将 UserController 复 制 一 份 ， 改 名 为 UserDelegate， 并 把 继承 MultiActionController 去 掉 即 可 ， 其 他 无 需 改 变 。 


** (2、spring 配 置 文件 chapter4-servlet.xml** 


<! 一 委托 对 象 - -> 
<bean id="userDelegate" class="cn,javass.chapter4.web.controller,.UserDeJegate"> 
<property name="userService" ref="userService"/> 
<property name="createView" value="Uuser2/create"/> 
<property name="updateView" value="user2/update"/> 
<property name="deleteView" value="user2/delete"/> 
<property name="]listView" value="user2/1list"/> 
<property name="redirectToListView" value="redirect:/user2/list"/> 
</bean> 
<1 一 控制 器 对 象 - -> 
<bean name="/user2/**" 
class="org.springframework.web.servlet.mvc.multiaction.MultiActionController"> 
<property name="delegate" ref="userDelegate"/> 
<property name="methodNameResolver" ref="parameterMethodNameResolver"/> 
</bean> 


delegate : 控制 器 对 象 通过 delegate 属 性 指定 委托 对 象 ， 即 实际 调用 delegate 委 托 对 象 的 功能 方 
法 。 


忆 


methodNameResolver : 此 处 我 们 使 用 ParameterMethodNameResolver 解 析 器 ; 


<!—ParameterMethodNameResolver --> 
<bean id="parameterMethodNameResolver" 
class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver"> 
<1-- 1、 根 据 请 求 参数 名 解析 功能 方法 名 --> 
<property name="methodPparamNames" value="create,update,delete"/> 
<1-- 2、 根 据 请 求 参数 名 的 值 解析 功能 方法 名 --> 
<property name="paramName" value="action"/> 
<1-- 3、 逻 辑 方法 名 到 睦 实 方法 名 的 映射 - -> 
<property name="logicalMappings"> 
<props> 
<prop key="doList">list</prop> 
</props> 
</property> 
<!-4、 黑 认 执 行 的 功能 处 理 方法 --> 
<property name="defaultMethodName" value="list"/> 
</bean> 


**1、** methodParamNames : create,update,delete ， 当 请 求 中 有 参数 名 为 这 三 个 的 将 被 
映射 为 功能 方法 名 ， 如 “<input type="submit" name="create" value=" 新 增 "/>” 提 交 后 解析 得 到 
的 功能 方法 名 为 create; 


**2、paramName : ** 当 请 求 中 有 参数 名 为 action， 则 将 值 映射 为 功能 方法 名 ， 如 “<input 
type="hidden" name="action" value="delete"/>”， 提 交 后 解析 得 到 的 功能 方法 名 为 delete ; 

**3、logicalMappings : ** 逻辑 功能 方法 名 到 监 实 功能 方法 名 的 映射 ， 如 : 
http://localhost:9080/springmvc-chapter4/user2?action=doList ; 

首先 请 求 参数 “action=doList”， 则 第 二 步 解 析 得 到 逻辑 功能 方法 名 为 doList ; 

本 步 又 会 把 doList 再 转换 为 盖 实 的 功能 方法 名 list。 

**4、defaultMethodName : ** 以 上 步骤 如 果 没 有 解析 到 功能 处 理 方法 名 ， 默 认 执 行 的 方法 名 。 

** (3、 视 图 页 面 ** 


** (3.1、1list 页 面 (WEB-INF/jsp/user2/list.jsp) ** 


<a href="${pageContext.request.contextPath}/user2?action=create"> 用 户 新 增 </a><br/> 
<table border="1" width="50%"> 
<tr> 
<th> 用 户 名 </th> 
<th> 盖 实 姓 名 </th> 
<th> 操 作 </th> 
</tr> 
<c:forEach items="${userList}" var="user"> 
<tr> 
<td>${user.username }</td> 
<td>${user.realname }</td> 
<td> 
<a href="${pageContext.request.contextPpath}/user2?action=update&username=${Uuser 
| 
<a href="${pageContext.request.contextPath}/user2?action=delete&username=${Uuser 
</td> 
</tr> 
</c:forEach> 
</table> 


男 | 


** (3.2、Uupdate 页 面 (WEB-INF/jsp/user2/update.jsp) ** 





<form action="${pageContext.request.contextPath}/user2" method="post"> 

<input type="hidden" name="action" value="update"/> 

用 户 名 : <input type="text" name="username" value="${command.username}"/><br/> 
真实 姓名 : <input type="text" name="realname" value="${command.realname}"/><br/> 
<input type="submit" value=" 更 新 "/> 

</form> 


通过 参数 name="action" value="Update” 来 指定 要 执行 的 功能 方法 名 update。 


** (3.3、create 页 面 (WEB-INF/jsp/user2/create.jsp) ** 


<form action="${pageContext.request.contextPath}/user2" method="post"> 

用 户 名 : <input type="text" name="username" value="${command.username}"/><br/> 
真实 姓名 : <input type="text" name="realname" value="${command.realname}"/><br/> 
<input type="submit" name="create" value=" 新 增 "/> 

</form> 


通过 参数 name="Create” 来 指定 要 执行 的 功能 方法 名 create。 


rE 


使 用 ParameterMethodNameResolver 将 进行 如 下 解析 : 


http://localhost:9080/springmvc-chapter4/user2?create 一 一 一 一 >create 功 能 处 理 方法 名 ( 参 
数 名 映射 ) ，; 
http://localhost:9080/springmvc-chapter4/user2?action=create 一 一 一 一 >create 功 能 处 理 方 法 


名 《参数 值 映 射 ) ; 
http://localhost:9080/springmvc-chapter4/user2?update 一 一 一 一 >update 功 能 处 理 方 法 名 ; 


http://localhost:9080/springmvc-chapter4/user2?action=update 一 一 一 一 >update 功 能 处 理 方 
法 名 ; 
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http://localhost:9080/springmvc-chapter4/user2?delete 一 一 一 一 >delete 功 能 处 理 方法 名 ; 
http://localhost:9080/springmvc-chapter4/user2?action=delete 一 一 一 一 >delete 功 能 处 理 方 法 
2 

http://localhost:9080/springmvc-chapter4/user2?doList 一 一 一 一 > 通过 |ogicalMappings 解 析 


为 list 功 能 处 理 方 法 。 


http://localhost:9080/springmvc-chapter4/user2?action=doList 一 一 一 一 > 通过 
logicalMappings 解 析 为 list 功 能 处 理 方法 。 


http://localhost:9080/springmvc-chapter4/user2 一 一 一 一 > 默认 的 功能 处 理 方法 名 list ( 默 
庆 几 二 


原创 内 容 ， 转 载 请 注 明 iteye http://jinnianshilongnian.iteye.com/ 
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‘ceateBinder(request, command) 
initBinder (request, binder) 扩展 点 
binder .bind(request): 


OD 
四 
四 
@ onBind(request, command , errors): 扩展 点 
@ 
© 
| 





validators 验 证 





onBindAndV alidate(request, command, errors); 


arors (BindExce ee 
功能 处 理 方法 


流程 : 
1、 首 先 创建 数据 绑 定 器 ， 在 此 此 会 创建 ServletRequestDataBinder 类 的 对 象 ， 并 设置 
messageCodesResolver (错误 码 解 析 器 ) ; 


2、 提 供 第 一 个 扩展 点 ， 初 始 化 数据 绑 定 器 ， 在 此 处 我 们 可 以 覆盖 该 方法 注册 自 定义 的 
PropertyEditor (请 求 参 数 一 “> 命令 对 象 属性 的 转换 ) ; 





3、 进 行 数据 绑 定 ， 即 请 求 参数 一 > 命令 对 象 的 绑 定 ; 





4、 提 供 第 二 个 扩展 点 ， 数 据 绑 定 完 成 后 的 扩展 点 ， 此 处 可 以 实现 一 些 自 定义 的 绑 定 动作 ; 


5、 验 证 器 对 象 的 验证 ， 验 证 器 通过 validators 注 入 ， 如 果 验 证 失败 ， 需 要 把 错误 信息 放 入 
Errors (此 处 使 用 BindException 实 现 ) ; 


6、 提 供 第 三 个 扩展 点 ， 此 处 可 以 实现 自 定义 的 绑 定 /验证 避 辑 ; 
7、 将 errors 传 入 功能 处 理 方法 进行 处 理 ， 功 能 方法 应 该 判断 该 错误 对 象 是 否 有 错误 进行 相应 


的 处 理 。 


4.16.1、 数 据 类 型 转换 


请 求 参 数 〈String ) > 命令 对 象 属性 〈 可 能 是 任意 类 型 ) 的 类 型 转换 ， 即 数据 绑 定 时 的 类 
型 转换 ， 使 用 PropertyEditor 实 现 绑 定 时 的 类 型 转换 





O 〇 


一 、Spring 内 建 的 PropertyEditor 如 下 所 示 : 


ByteArrayPropertyEditor 


ClassEditor 


CustomBooleanEditor 


CustomCollectionEditor 


CustomNumberEditor 


FileEditor 


InputStreamEditor 


LocaleEditor 


PatternEditor 
PropertiesEditor 
URLEditor 


StringTrimmerEditor 


CustomDateEditor 


说 明 


String< 





>bytel] 


String< 一 一 >Class 当 类 没有 发 现 抛 
i IllegalArgumentException 





String< >Booleantrue/yes/on/1 转 换 为 true ， 
false/no/off/0 转 换 为 false 


数组 /Collection 一 一 >Collection 首 通 值 一 一 
>Collection (只 包含 一 个 对 象 ) 如 String 一 一 
>Collection 不 允许 Collection >String (单方 向 转 
































换 ) 

String< >Number(Integer 、 Long、Double) 

String< >File 

String 一 一 >InputStream 单 向 的 ， 不 能 InputStream 
>String 

String< 一 一 >Locale ， (String 的 形式 为 [语言 ]/ 国 家 下 变 

量 ]， 这 与 Local 对 象 的 toString() 方 法 得 到 的 结果 相同 ) 

String< >Pattern 

String< >java.lang.Properties 

String< >URL 





一 个 用 于 trim 的 String 类 型 的 属性 编辑 器 如 默认 删除 两 
边 的 空格 ，charsToDelete 属 性 : 可 以 设置 为 其 他 字符 
emptyAsNull 属 性 : 将 一 个 空 字 符 串 转化 为 null 值 的 选 

项 o 





String< >java.util.Date 


二 、Spring 内 建 的 PropertyEditor 支 持 的 属性 (符合 JavaBean 规 范 ) 操作 : 


默 


事 沁 人 碎 沿 闫 


过 


一 | 芽 二 | 一 | 国生 一 二 


表达 式 设 值 / 取 值 说 明 


属性 username 设 值 方法 setUsername()/ 取 值 方法 


username getUsername() 或 isUsername() 


属性 schoolnfo 的 诅 套 属性 schoolType 设 值 方 法 
schoolnfo.schoolType ”getSchoolnfo().setSchoolType()/ 取 值 方法 
getSchoolnfo().getSchoolType() 


a - 
hobbyList[o] 属 9 一 个 元 素 索引 属性 可 能 数组 、 列 表 
map[key] 属性 map (java.util.Map 类 型 ) map 中 key 对 应 的 值 

三 、 示 例 : 


接 下 来 我 们 写 自 定义 的 属性 编辑 器 进行 数据 绑 定 : 
(1、 模 型 对 象 : 


package cn.javass.chapter4.model; 
// 省 略 import 
public class DataBinderTestModel { 
private String username; 
private boolean bool;//Boolean 值 测试 
private SchoolInfoModel schooInfo; 
private List hobbyList;// 集 合 测试 ， 此 处 可 以 改 为 数组 /Set 进 行 测试 
private Map map;//Map 测 试 
private PhoneNumberModel bomen mb re ot ng 定义 对 象 的 转换 测试 
private Date date;// 日 期 类 型 测试 
private UserState state;//String 一 >Enum 类 型 转换 测试 
// 省 略 getter/setter 


} 


package cn.javass.chapter4.model; 

// 如 格式 010-12345678 

public class PhoneNumberModel { 
private String areaCode;// 区 号 
private String phoneNumber;// 电 话 号 码 
// 省 略 getter/setter 


(2、PhoneNumber 属 性 编辑 器 


前 台 输 入 如 010-12345678 自 动 转 换 为 PhoneNumberModel 。 


package cn.javass.chapter4.web.controller.support.editor; 

// 省 略 import 

public class PhoneNumberEditor extends PropertyEditorSupport 
Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); 


@Override 
public void setAsText(String text) throws IllegalArgumentException { 
if(text == null || !StringUtils.hasLength(text)) { 


setValue(null); // 如 果 没 值 ， 设 值 为 hull 
} 
Matcher matcher = pattern.matcher(text); 
if(matcher.matches()) { 
PhoneNumberModel] phoneNumber = new PhoneNumberModel(); 
phoneNumber .setAreaCode(matcher .group(1)); 
phoneNumber .setPhoneNumber (matcher .group(2)); 
setValue(phoneNumber ) ; 
} else { 


throw new IllegalArgumentException(String.format(" 类 型 转换 失败 ， 需 要 格式 [010-123< 
} 
} 


Q@Override 

public String getAsText() { 

PhoneNumberModel phoneNumber = ((PhoneNumberModel)getValue()); 

return phoneNumber == null ? "" : phoneNumber.getAreaCode() + "-" + phoneNumber.g 





PropertyEditorSupport : 一 个 PropertyEditor 的 支持 类 ; 





setAsText : 表示 将 String 一 一 >PhoneNumberModel， 根 据 正 则 表达 式 进 行 转换 ， 如 果 转 换 
失败 抛 出 异常 ， 则 接 下 来 的 验证 器 会 进行 验证 处 理 ; 


getAsText : 表示 将 PhoneNumberModel 





>String。 
(3、 控 制 器 
需要 在 控制 器 注册 我 们 自 定义 的 属性 编辑 器 。 


此 处 我 们 使 用 AbstractCommandController， 因 为 它 继 承 了 BaseCommandController， 拥 有 缘 


宋 流 程 。 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class DataBinderTestController extends AbstractCommandController { 
public DataBinderTestController() { 
setcommandClass(DataBinderTestModel.class); // 设 置 命令 对 象 
setCommandName("dataBinderTest");// 设 置 命令 对 象 的 名 字 


@Override 

protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Objec 
// 输 出 command 对 象 看 看 是 否 绑 定 正确 
System.out,println(command ) ， 
return new ModelAndView("bindAndvalidate/success").addobject("dataBinderTest", co 


@Override 

protected void initBinder(HttpServletRequest request, ServletRequestDataBinder binder 
super.initBinder(request, binder); 
// 注 册 自 定义 的 属性 编辑 器 
//1 “日 期 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
CustomDateEditor dateEditor = new CustomDateEditor(df, true); 
// 表 示 如 果 命 令 对 象 有 Date 类 型 的 属性 ， 将 使 用 该 属性 编辑 器 进行 类 型 转换 
binder.registerCustomEditor(Date.class, dateEditor); 
// 自 定义 的 电话 号 码 编辑 器 
binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); 





initBinder: 第 一 个 扩展 点 ， 初 始 化 数据 绑 定 器 ， 在 此 处 我 们 注册 了 两 个 属性 编辑 器 ; 


CustomDateEditor : 自 定义 的 日 期 编辑 器 ， 用 于 在 String< 一 一 > 日 期 之 间 转 换 ; 





binder.registerCustomEditor(Date.class, dateEditor) : 表示 如 果 命 令 对 象 是 Date 类 型 ， 则 使 
用 dateEditor 进 行 类 型 转换 ; 


PhoneNumberEditor : 自 定义 的 电话 号 码 属 性 编辑 器 用 于 在 String< 
PhoneNumberModel 之 问 转换 ; 


> 





binder.registerCustomEditor(PhoneNumberModel.class, newPhoneNumberEditor()) : 表示 
如 果 命令 对 人 象 是 PhoneNumberModel 类 型 ， 则 使 用 PhoneNumberEditor 进 行 类 型 转换 ; 


** (4、spring 配 置 文件 chapter4-servlet.xml** 


<bean name="/dataBind" 
class="cn.javass.chapter4.web.controller .DataBinderTestController"/> 


(5、 视 图 页 面 (WEB-INF/jsp/bindAndValidate/success.jsp ) 


EL phoneNumber:${dataBinderTest.phoneNumber}<br/> 
EL state:${dataBinderTest.state}<br/> 
EL date:${dataBinderTest.date}<br/> 


视图 页 面 的 数据 没有 预期 被 格式 化 ， 如 何 进行 格式 化 显示 呢 ?请 参考 【第 七 章 注解 式 控 制 器 
的 数据 验证 、 类 型 转换 及 格式 化 】。 


(6、 测 试 : 


1、 在 浏览 器 地 址 栏 输入 请 求 的 URL， 如 


http://localhost:9080/springmvc-chapter4/dataBind? 
username=zhang&bool=yes&schoolnfo.specialty=computer&hobbyList[0]=program&hobbytLi 
st[1]=music&map[key1]=value1&map[key2]=value2&phoneNumber=010- 
12345678&date=2012-3-18 16:48:48&state=blocked 


2、 控 制 器 输出 的 内 容 : 


DataBinderTestModel [username=zhang, bool=true, schoolnfo=SchoollnfoModel 
[SchoolType=null, schoolName=null, specialty=computer], hobbyList=[program, music]， 
map={key1=value1, key2=value2}, phoneNumber=PhoneNumberModel [areaCode=010， 
phoneNumber=12345678], date=Sun Mar 18 16:48:48 CST 2012, state= 锁 定 ] 


类 型 转换 如 图 所 示 : 





| Yn Ds ey 
Elenentz | 男 |Resources | Netwrk | (BB Scripts Tinoling NProfilos hudits Consols 
- 凌 





Home 

Pet 了 Henders Preview Respon=e Cookies TiminEg 

| 去 dataBind Accopt; text/html,application/xhtwl+xml,application/xHl;q=0.9,*/+;q=0.8 
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Cookie: JSESSIONID*D81BFA44D34A7608A0COSEE 3732296A8 
ost:- Yocalhost: 9650 
~Eent: Mozilla15.0 (Yindows NT 5,1) AppletebKit/535.11 (NHTML, like Gecko) Chrome/17.0.963.79 5afari/535.11 








VQuery Strine 了 Parameters "iew URL encoded Public class DataBinderTestHModel { 
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hobbyList[0]: prograa- 一 一 一 private SchoollnfoModel schoolnfo; 
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Content~Trpe: text/html;charset=UTF -5 
四 、 注 册 PropertyEditor 
1、 使 用 WebDataBinder 进 行 控制 器 级 别 注册 PropertyEditor (控制 器 独 享 ) 


如 【三 、 示 例 】" 中 所 使 用 的 方式 ， 使 用 WebDataBinder 注 册 控 制 器 级 别 的 PropertyEditor ， 
这 种 方式 注册 的 PropertyEditor 只 对 当前 控制 器 独 享 ， 即 其 他 的 控制 器 不 会 自动 注册 这 个 
PropertyEditor， 如 果 需 要 还 需要 再 注册 一 下 。 


2、 使 用 **webBindingInitializer 批 量 注册 ** PropertyEditor 


如 果 想 在 多 个 控制 器 同时 注册 多 个 相同 的 PropertyEditor 时 ， 可 以 考虑 使 用 
ts 9 


示例 : 


(1、 实 现 WebBindinglnitializer 


package cn.javass.chapter4.web.controller.support.initializer; 
// 省 略 import 
public class MywWebBindingInitializer implements WebBindingInitializer { 
Q@Override 
public void initBinder (WebDataBinder binder, WebRequest request) { 
// 注 册 自 定义 的 属性 编辑 器 
/7/1、 日 期 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
CustomDateEditor dateEditor = new CustomDateEditor(df, true); 
// 表 示 如 果 命令 对 象 有 Date 类 型 的 属性 ， 将 使 用 该 属性 编辑 器 进行 类 型 转换 
binder.registerCustomEditor(Date.class, dateEditor); 
// 自 定义 的 电话 号 码 编辑 器 
binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); 


通过 实现 WebBindinglnitializer 并 通过 binder 注 册 多 个 PropertyEditor。 
(2、 修 改 【 三 、 示 例 】 中 的 DataBinderTestController， 注 释 掉 initBinder 方 法 ; 


(3、 修 改 chapter4-servlet.xml 配 置 文件 : 


<!-- 注册 WebBindingInitializer 实 现 --> 
<bean id="mywebBindingInitializer" class="cn.javass.chapter4.web.controller.support.initi 
<bean name="/dataBind" class="cn.javass.chapter4.web.controller.DataBinderTestController" 
<!-- 注入 WebBindingInitializer 实 现 --> 
<property name="webBindingInitializer" ref="myWebBindingInitializer"/> 
</bean> 


国 — Oo 





(4、 党 试 访问 * 【三 、 示 例 】” 中 的 测试 URL 即 可 成 功 。 


使 用 WebBindinglnitializer 的 好 处 是 当 你 需要 在 多 个 控制 器 中 需要 同 dt 多 个 相同 的 
PropertyEditor 可 以 在 WebBindinglnitializer 实 现 中 注册 ， 0 需要 在 控制 器 中 注入 
WebBindinglnitializer 即 可 注入 多 个 PropertyEditor 。 


3、 全 局 级 别 注 册 PropertyEditor (全 局 共享 ) 


只 需要 将 我 们 自 定义 的 PropertyEditor 放 在 和 你 的 模型 类 同 包 下 即 可 ， 且 你 的 Editor 命 名 规则 
必须 是 “模型 类 名 Editor， 这 样 Spring 会 自动 使 用 标 oa 自动 识别 ， 如 图 所 


示 : 


日 -名 rc 
日 .人知 en 
OD- Javass 
-9 chapter4 
日 个 model 
DatabinderTestllodel, jara 
PhoneNumberllodel . java 









PhoneNumberlodelFditor, java 
J| SchoolInfoWodel. java 
Vserllodel. java 





UserState. java 


WorkInfoModel, java 








此 时 我 们 
把 "DataBinderTestController” 的 "binder.registerCustomEditor(PhoneNumberModel.class， 
new PhoneNumberEditor());” 注 释 掉 ， 再 党 试 访问 *【 三 、 示 例 】” 中 的 测试 URL 即 可 成 功 。 


这 种 方式 不 仅仅 在 使 用 Spring 时 可 用 ， 在 标准 的 JavaBean 等 环境 都 是 可 用 的 ， 可 以 认为 是 全 
局 共享 的 (不 仅仅 是 Spring 环 境 ) 。 


PropertyEditor 被 限制 为 只 能 String< 一 一 >Object 之 问 转 换 ， 不 能 Object< 一 一 >Object， 
Spring3 提 供 了 更 强大 的 类 型 转换 


(Type **conversion) 支持 ， 它 可 以 在 任意 对 象 之 间 进行 类 型 转换 ， 不 仅仅 是 String** < **_&gt;0bject。** 


如 果 我 在 地 址 栏 输入 错误 的 数据 ， 即 数据 绑 定 失败 ，Spring Web MVC 该 如 何 处 理 呢 ? 如 果 我 
输入 的 数据 不 合法 呢 ? 如 用 户 名 输入 100 个 字符 ( 超 长 了 ) 那 又 该 怎么 处 理 呢 ? 出 错 了 需要 错 
误 消息 ， 那 错误 消息 应 该 是 硬 编码 ?还 是 可 配置 呢 ? 


接 下 来 我 们 来 学 习 一 下 数据 验证 器 进行 数据 验证 吧 。 
私 熟 在 线 学 习 网 原创 内 容 (http://sishuok.com) 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/5677.html]】 


第 四 章 Controller 接 口 控制 器 详解 (7 完 ) 一 一 跟 
着 开 涛 学 SpringMVC 


4.16.2、 数 据 验 十 


1、 数 据 绑 定 失败 : 比如 需要 数字 却 输入 了 字母 ; 


2、 数 据 不 合法 : 可 以 认为 是 业务 错误 ， 通 过 自 定义 验证 器 验证 ， 如 用 户 名 长 度 必 须 在 5-20 之 
间 ， 我 们 却 输入 了 100 个 字符 等 ; 


3、 错 误 对 象 : 当 我 们 数据 绑 定 失败 或 验证 失败 后 ， 错 误 信息 存放 的 对 象 ， 我 们 叫 错误 对 象 ， 
在 Spring Web MVC 中 Errors 是 有 具体 的 代表 者 ; 线程 不 安全 对 象 ; 


4、 错 误 消息 : 是 硬 编码 ， 还 是 可 配置 ? 实际 工作 应 该 使 用 配置 方式 ， 我 们 只 是 把 错误 码 
(errorCode) 放 入 错误 对 象 ， 在 展示 时 读 取 相 应 的 错误 消息 配置 文件 来 获取 要 显示 的 错误 消 
息 (errorMessage) ; 


4.16.2.1、 验 证 流程 


由 


外 【数据 不 合法 〈 自 定义 验证 器 验证 ) 


1、 首 先进 行 数据 绑 定 验证 ， 如 果 验 证 失败 会 通过 MessageCodesResolver 生 成 错误 码 放 入 
Errors 错 误 对 象 ; 





2、 数 据 不 合法 验证 ， 通 过 自 定 义 的 验证 器 验证 ， 如 果 失 败 需 要 手动 将 错误 码 放 入 Errors 错 误 
对 象 ; 


4.16.2.2、 错 误 对 象 和 错误 消息 


鞭 误 对 象 的 代表 者 是 Errors 接 口 ， 并 且 提 供 了 几 个 实现 者 ， 在 Spring Web MVC 中 我 们 使 用 的 
是 如 下 实现 : 


起 Erroers 
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(TD) BindineResult | 


起 


加 BindExcepti on | 








相关 的 错误 方法 如 下 : 


Errors : 存储 和 暴露 关于 数据 绑 定 错误 和 验证 错误 相关 信息 的 接口 ， 提 供 了 相关 存储 和 获取 
着 误 消息 的 方法 : 


package org.springframework.validation; 

public interface Errors { 
My Ee 息 (验证 / 绑 定 对 象 全 局 的 ) 三 三 三 三 三 一 三 二 三 二 一 一 三 二 一 三 三 三 一 一 二 一 一 一 一 三 三 三 三 
// 注 册 一 个 全 局 的 错误 码 〈 ) 
void reject(String errorCode); 
// 注 册 一 个 全 局 的 错误 码 ， 当 根据 errorCode 没 有 找到 相应 错误 消息 时 ， 使 用 defaultMessage 作 为 错误 消息 
void reject(String errorCode, String defaultMessage); 
// 注 册 一 个 全 局 的 错误 码 ， 当 根据 errorCode 没 有 找到 相应 错误 消息 时 ( 带 错误 参数 的 ) ， 使 用 defaultMessage 作 
void reject(String errorCode, Object[] errorArgs, String defaultMessage); 
XK 三 二 圭 二 三 夸 志 三 三 寺 二 二 二 二 二 圭 寺 二 二 二 二 二 二 二 二 人 息 (验证 / 绑 定 整个 对 象 的 ) 三 三 三 三 三 三 三 三 三 三 二 三 三 三 三 三 三 一 三 二 三 三 三 三 三 三 三 三 一 
/=== 错误 消 息 (验证 / 绑 定 对 象 字 段 的 ) 二 二 三 三 三 三 三 三 三 三 三 三 三 三 二 三 三 二 二 二 二 二 三 二 三 三 三 三 三 
// 注 册 一 个 对 象 字 段 的 错误 码 ，fie1d 指 定 验 证 失败 的 字段 名 
void rejectVvalue(String field, String errorCode); 
void rejectValue(String field, String errorCode, String defaultMessage); 
void rejectValue(String field, String errorCode, Object[] errorArgs, String defaultMess 

















boolean hasErrors(); //// 是 否 有 错误 


boolean hasGlobalErrors(); // 是 否 有 全 局 错误 
boolean hasFieldErrors(); // 是 否 有 字段 错误 
Object getFieldValue(String field); // 返 回 当前 验证 通过 的 值 ， 或 验证 失败 时 失败 的 值 ; 





getFieldValue : 可 以 得 到 验证 失败 的 失败 值 ， 这 是 其 他 Web 层 框架 很 少 支持 的 ， 这 样 就 可 以 
给 用 户 展示 出 错时 的 值 (而 不 是 空 或 其 他 的 默认 值 等 ) 。 


BindingResult : 代表 数据 绑 定 的 结果 ， 继 承 了 Errors 接 口 。 


BindException : 代表 数据 绑 定 的 异常 ， 它 继承 Exception， 并 实现 了 BindingResult， 这 是 内 
部 使 用 的 错误 对 象 。 


示例 : 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class ErrorController extends AbstractCommandController { 
public ErrorController() { 
setcommandClass(DataBinderTestModel .class); 
setCcommandName ("command"); 


@Override 
protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Ob 
// 表 示 用 户 名 不 为 空 
errors.reject("username.not.empty"); 
// 带 有 默认 错误 消息 
errors.reject("username .not.empty1"，" 用 户 名 不 能 为 空 1") ; 
// 带 有 参数 和 默认 错误 消息 
errors.reject("username.length.error", new Object[]{5, 10}); 


// 得 到 错误 相关 的 模型 数据 
Map model = errors.getModel(); 
return new ModelAndView("bindAndValidate/error", model); 





errors,reject("username .not.empty") : 注册 全 局 错误 码 “username .not.empty”， 我 们 必须 提供 messageSo 


[ss 





errors.reject("username.not.empty1", "用 户 名 不 能 为 空 1") : 注册 全 局 错误 
码 “Username.not.empty1”， A ea 没 没有 找到 错误 
码 “Username.not.empty1” 对 应 的 错误 信息 ， 则 将 显示 默认 消息 “用 户 名 不 能 为 空 人 1”; 


errors.reject("username.length.error", new Object[]{5, 10}) : 错误 码 

"Usemamelengih emer ， 而 且 错 误 信 息 需 要 两 个 参数 ， 如 我 们 在 我 们 的 配置 文件 中 定义 "用 
户 名 长 度 不 合法 ， 长 度 必 须 在 {0} 到 {1} 之 间 ”， 则 实际 的 错误 消息 为 “< 用户 名 长 度 不 合法 ， 长 度 
必须 在 5 到 10 之 间 ” 


errors.getModel() : 当 有 错误 信息 时 ， 一 定 将 errors.getModel() 放 入 我 们 要 返回 的 
ModelAndView 中 ， 以 便 使 用 里 边 的 错误 对 象 来 显示 错误 信息 。 


** (2、spring 配 置 文件 chapter4-servlet.xml** 


<bean id="messageSource" 


class="org.springframework.context.support.ReloadableResourceBundleMessageSource"> 
<property name="basename" value="classpath:messages"/> 
<property name="fileEncodings" value="utf-8"/> 
<property name="cacheSeconds" value="120"/> 
</bean> 


<bean name="/error" class="cn.javass.chapter4.web.controller.ErrorController"/> 
二 | 


messageSource : 用 于 获取 错误 码 对 应 的 错误 消息 的 ， 而 且 bean 名 字 默 认 必 须 是 
messageSource。 


messages.properties (需要 执行 NativeToAscii) 


Username .not.empty= 用 户 名 不 能 为 空 
username.length.error= 用 户 名 长 度 不 合法 ， 长 度 必须 在 {0} 到 {1} 之 间 


(3、 视 图 页 面 (WEB-INF/jsp/bindAndValidate/error.jsp) 


<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 
<!1-- 表单 的 默认 命令 对 象 名 为 command --> 
<form:form commandName="command"> 
<form:errors path="*"></form:errors> 
</form:form> 


form 标 签 库 : 此 处 我 们 使 用 了 spring 的 form 标 签 库 ; 


<form:form commandName="command">: 表 示 我 们 的 表单 标签 ，commandName 表 示 绑 
定 的 命令 对 象 名 字 ， 黑 认为 command ; 


A 


<form:errors path="*"></form:errors> : 表示 显示 错误 信息 的 标签 ， 如 果 path 为 “表示 显示 
所 有 错误 信息 。 


接 下 来 我 们 来 看 一 下 数据 绑 定 失败 和 数据 不 合法 时 ， 如 何 处 理 。 

4.16.2.3、 数 据 绑 定 失败 

如 我 们 的 DataBinderTestModel 类 : 

bool : boolean 类 型 ， 此 时 如 果 我 们 前 台 传 入 非 兼 容 的 数据 ， 则 会 数据 绑 定 失败 ; 
date : Date 类 型 ， 此 时 如 果 我 们 前 台 传 入 非 兼 容 的 数据 ， 同 样 会 数据 绑 定 失败 ; 


phoneNumber : 自 定 义 的 PhoneNumberModel 类 型 ， 如 果 如 果 我 们 前 台 传 入 非 兼 容 的 数据 ， 
同样 会 数据 绑 定 失败 。 


示例 : 


(1、 控 制 器 ，DataBinderErrorTestController 。 


package cn.javass.chapter4.web.controller; 
// 省 略 import 
public class DataBinderErrorTestController extends SimpleFormController { 
public DataBinderErrorTestController() { 
setcommandClass(DataBinderTestModel .class); 
setCcommandName("dataBinderTest"); 


@Override 


protected ModelAndView showForm(HttpServletRequest request, HttpServletResponse re 


// 如 果 表 单 提交 有 任何 错误 都 会 再 回 到 表单 展示 页 面 
System.out,println(errors ) ， 
return super.showForm(request, response, errors); 


@Override 
protected void doSubmitAction(Object ommend) throws Exception { 
System.out.println(command); // 表 单 提交 成 功 〈 数 据 绑 定 成 功 ) 进行 


Q@Override 


功能 处 理 


protected void initBinder(HttpServletRequest request, ServletRequestDataBinder bin 


super.initBinder(request, binder); 
// 注 册 自 定义 的 属性 编辑 器 
//1、 日 期 


DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
CustomDateEditor dateEditor = new CustomDateEditor(df, true); 


// 表 示 如 果 命 令 对 象 有 Date 类 型 的 属性 ， 将 使 用 该 属性 编辑 器 进行 类 型 转换 
binder.registerCustomEditor(Date.class, dateEditor); 


// 自 定义 的 电话 号 码 编辑 器 


binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor() 





此 处 我 们 使 用 SimpleFormController ; 


showForm : 展示 表单 ， 当 提交 表单 有 任何 数据 绑 定 错误 会 再 回 到 该 
此 处 我 们 打印 错误 对 象 ) ; 


了 于 表单 输入 (在 


doSubmitAction : 表单 提交 成 功 ， 只 要 当 表 单 的 数据 到 命令 对 象 绑 定 成 功 时 ， 才 会 执行 


** (2、spring 配 置 文件 chapter4-servlet.xml** 


<bean name="/dataBindError" 
class="cn.javass.chapter4.web.controller .DataBinderErrorTestController"> 
<property name="formView" value="bindAndVvalidate/input"/> 
<property name="successView" value="bindAndValidate/success"/> 
</bean> 


(3、 视 图 页 面 (WEB-INF/jsp/bindAndValidate/ input.jsp) 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 


<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 
<1-- 表单 的 命令 对 象 名 为 dataBinderTest --> 
<form:form commandName="dataBinderTest"> 
<form:errors path="*" cssStyle="color:red"></form:errors><br/><br/> 
bool:<form:input path="bool"/><br/> 
phoneNumber:<form:input path="phoneNumber"/><br/> 
date:<form:input path="date"/><br/> 
<input type="submit" value=" 提 交 "/> 
</form:form> 


男 本 


:| 





此 处 一 定 要 使 用 form 标 签 库 ， 借 此 我 们 可 以 看 到 它 的 强大 支持 〈 别 的 大 部 分 Web 框 架 所 不 具 
备 的 ， 展 示 用 户 验 证 失败 的 数据 ) 。 


<form:form commandName="dataBinderTest"> : 指定 命令 对 象 为 dataBinderTest ， 默 认 
command ; 


<form:errors path="*" cssStyle="color:red"></form:errors> : 显示 错误 消息 ， 当 提交 表单 有 错 
误 时 展示 错误 消息 (数据 绑 定 错误 /数据 不 合法 ) ; 


<form:input path="boo/"> : 等 价 于 (<input type=’text>) ， 但 会 从 命令 对 象 中 取出 bool 属 性 
进行 填充 value 属 性 ， 或 如 果 表 单 提 交 有 错误 会 从 错误 对 象 取出 之 前 的 错误 数据 (而 非 空 或 默 
认 值 ) ; 


<input type="submit" value=" 提 交 "> : spring 没 有 提供 相应 的 提交 按钮 ， 因 此 需要 使 用 html 
的 。 


(4、 测 试 


在 地 址 栏 输入 如 下 地 址 : http://localhost:9080/springmvc-chapter4/dataBindError 


oo [ww 
phoneNumber: I 23 
date: [23 


提交 


全 部 是 错误 数据 ， 即 不 能 绑 定 到 我 们 的 命令 对 象 ; 
当 提 交 表 单 后 ， 我 们 又 回 到 表单 输入 页 面 ， 而 且 输 出 了 一 堆 错误 信息 


Failed to convert property value of type java. lang. String to required type boolean for property 
bool: nested exception is java, lang, IllegalAregumentException: Invalid boolean value [www] 
Failed to convert property value of type java, lang, String to required type java. util,Date for 
property date; nested exception is java. lang. Illegal AreumentException: Could not parse date: 
Unparseable date: “123” 

Failed to convert property value of type java. lang. String to required type 

cn. javass. chapter3. model. PhoneNumberllodel for property phonelNumber; nested exception is 


java. lang. IllegalArgumentException: 类 型 特 换 失 败 ， 需 要 格式 [010-12345678] ,但 格式 是 [123] 


bool: [ww sw na i 错误 消息 
phoneNumber: EE 十 二 一 蚌 二 和 再 的 灌 吕 的 3 a 不 是 默认 值 1 字 ,其 
date:[23 

提交 





1、 错 误 消 息 不 可 读 ; 
2、 表 单元 素 可 以 显示 之 前 的 错误 的 数据 ， 而 不 是 默认 值 / 空 ; 
(5、 问 题 


这 里 最 大 的 问题 是 不 可 读 的 错误 消息 ， 如 何 让 这 些 错误 消息 可 读 呢 ? 


首先 我 们 看 我 们 的 showForm 方 法 里 输出 的 “errors” 错 误 对 象 信 息 : 


org.springframework.validation.BindException: org.springframework.validation.BeanProperty 
Field error in object 'dataBinderTest' on field 'bool': rejected value [www]; codes [type 
Field error in object 'dataBinderTest' on field 'date': rejected value [123]; codes [type 


Field error in object 'dataBinderTest' on field 'phoneNumber': rejected value [123]; code 


.了 _] 


te (类 型 不 匹配 ) 会 自动 生成 如 下 错误 码 (错误 码 对 应 的 错误 消息 按照 如 下 顺序 
依次 查找 ) 





1、typeMismatch. 命 令 对 象 名 .属性 
2、typeMismatch. 铅 性 名 

3 、typeMismatch. 属 性 全 限定 类 名 ( 包 名 .类 名 ) 
4、typeMismatch 


@ 内 部 使 用 MessageCodesResolver 解 析 数 据 绑 定 错误 到 错误 码 ， 默 认 
DefaultMessageCodesResolver， 因 此 想 要 详细 了 解 如 何 解 析 请 看 其 javadoc ; 


@ 建 议 使 用 第 1 个 进行 错误 码 的 配置 
此 修改 我 们 的 messages.properties 添 加 如 下 错误 消息 (需要 执行 NativeToAscii) 


typeMismatch.dataBinderTest.date= 您 输入 的 数据 格式 错误 ， 请 重新 输入 (格式 : 2012-03-19 22:17:17) 
#typeMismatch.date=2 

#typeMismatch.java.util.Date=3 

#typeMismatch=4 


| 
再 次 提交 表单 我 们 会 看 到 我 们 设置 的 错误 消息 : 


Failed to convert property value of type java, lang, String to required type boolean for property 
bool: nested Exception is java. a. 1 ang. Illegal hr ementhxcept ion: Invalid boolean walue [wwwj 


E | | ` 和 档 式 ， 2012-03-19 22:17:17) 
Failed to convert property re of type java. lang. String to redquired type 
cn. javass. chapter3. model. PhoneNumberllodel for property phoneNumber; nested exception is 


java. lang. Illegal ArgeumentException: 类 型 转换 失败 ， 需 要 格式 [010-12345678]， 但 格式 是 [123] 


bool: www 
phoneNumber: h 2 
date: [123 


提交 









到 此 ， 数 据 绑 定 错误 我 们 介绍 完了 ， 接 下 来 我 们 再 看 一 下 数据 不 合法 错误 。 
4.16.2.4、 数 据 不 合法 


1、 比 如 用 户 名 长 度 必 须 在 5-20 之 间 ， 而 且 必 须 以 字母 开头 ， 可 包含 字母 、 数 字 、 下 划 线 ; 
2、 比 如 注册 用 户 时 用 户 名 已 经 存在 或 邮箱 已 经 存在 等 ; 
3、 比 如 去 一 些 论坛 经 常会 发 现 ， 您 发 的 帖子 中 包含 xxx 屏 蔽 关键 字 等 。 


还 有 很 多 数据 不 合法 的 场景 ， 在 此 就 不 罗列 了 ， 对 于 数据 不 合法 ，Spring Web MVC 提 供 了 两 
种 验证 方式 : 


多 编程 式 验证 器 验证 
急 声 明 式 验证 

先 从 编程 式 验证 器 开始 吧 。 
4.16.2.4.1、 编 程式 验证 器 


一 、 验 证 器 接口 


package org.springframework.validation; 
public interface Validator { 

boolean supports(Class<?> clazz); 

void validate(Object target, Errors errors); 


} 


Validator 接 口 : 验证 器 ， 编 程 实现 数据 验证 的 接口 ; 
supports 方 法 : 当前 验证 器 是 否 支持 指定 的 clazz 验 证 ， 如 果 支 持 返 回 true 即 可 ; 


validate 方 法 : 验证 的 具体 方法 ，target 参 数 表 示 要 验证 的 目标 对 象 (如 命令 对 象 ) ，errors 表 
示 验 证 出 错 后 存放 错误 信息 的 错误 对 象 。 


示例 : 


(1、 验 证 器 实现 


package cn.javass.chapter4.web.controller.support.validator; 
// 省 略 import 
public class UserModelValidator implements Validator { 
private static final Pattern USERNAME PATTERN = Pattern.compile("[a-zA-Z]\\w{4,19}"); 
private static final Pattern PASSWORD_PATTERN = Pattern.compile("[a-zA-2Z0-9]{5,20}"); 
private static final Set<String> FORBINDDDEN_WORD_SET = new HashSet<String>(); 
static { 
FORBINDDDEN_WORD_SET.add("fuc k"); // 删 掉 空 格 
FORBINDDDEN_WORD_SET.add("admin"); 


Q@Override 
public boolean supports(Class<?> clazz) { 
return UserModel.class == clazz;// 表 示 只 对 UserModel 类 型 的 目标 对 象 实施 验证 
} 
Q@override 


public void validate(Object target, Errors errors) { 
// 这 个 表示 如 果 目 标 对 象 的 username 属 性 为 室 ， 则 表示 错误 (简化 我 们 手工 判断 是 否 为 空 ) 
ValidationUtils.rejectIifEmpty(errors, "username", "Username.not.empty"); 


UserModel user = (UserModel) target; 


if(!USERNAME_ PATTERN.matcher(user.getUsername()).matches()) { 
errors.rejectValue("username",， "username.not.illegal");// 如 果 用 户 名 不 合法 
} 


for(String forbiddenword : FORBINDDDEN WORD_ SET) { 
if(user.getUsername().contains(forbiddenword)) { 
errors.rejectValue("username", "username.forbidden", new Object[]{forbidden 
break; 


} 


if(!PASSWORD_PATTERN.matcher(user.getPassword()).matches()) { 
errors.rejectValue("password", "password.not.illegal",， "密码 不 合法 ");// 密 码 不 合法 





supports 方 法 : 表示 只 对 UserModel 类 型 的 对 象 验 证 ; 


validate 方 法 : 数据 验证 的 具体 方法 ， 有 如 下 几 个 验证 : 
1、 用 户 名 不 合法 〈 长 度 5-20， 以 字母 开头 ， 随 后 可 以 是 字母 、 数 字 、 下 划 线 ) 
USERNAME PATTERN.matcher(usergetUsername()).matches() /使 用 正则 表达 式 验 证 


errors.rejectValue("username", "username.not.illegal");// 验 证 失败 为 username 字 段 添加 错误 
码 


2、 屏 蔽 关键 词 : 即 用 户 名 中 含有 不 合法 的 数据 (如 admin) 


user.getUsername().contains(forbiddenWord) /用 contains 来 判断 我 们 的 用 户 名 中 是 否 含有 非 
法 关键 词 


errors.rejectValue("username", "username.forbidden", new Object[]{forbidqdenWord}, "您 的 用 
户 名 包含 非法 关键 词 ");// 验 证 失败 为 username 字 段 添加 错误 码 (参数 为 当前 屏蔽 关键 词 ) 
(默认 消息 为 "您 的 用 户 名 包含 非法 关键 词 ") 


3、 密 码 不 合法 


在 此 就 不 罗列 代码 了 ; 
4、ValidationUtils 


ValidationUtils.reject/fEmpty(errors, "username", "username.not.empty"); 
表示 如 果 目 标 对 象 的 username 属 性 数据 为 室 ， 则 添加 它 的 错误 码 ; 


内 部 通过 (value == null || !StringUtils.hasLength(value.toString())) 实现 判断 value 是 否 为 
空 ， 从 而 简化 代码 。 


** (2、spring 配 置 文件 chapter4-servlet.xml** 


<bean id="userModelValidator" 


class="cn.javass.chapter4.web.controller.support.validator.UserModelValidator"/> 
<bean name="/validator" 
class="cn.javass.chapter4.web.controller.RegisterSimpleFormController"> 
<property name="formView" value="registerAndValidator"/> 
<property name="successView" value="redirect:/success"/> 
<property name="validator" ref="userModelValidator"/> 
</bean> 


此 处 使 用 了 我 们 第 4.9 节 创建 的 RegisterSimpleFormController 。 


(3、 错 误 码 配 置 (messages.properties ) ， 需 要 执行 NativeToAscii 


username .not.empty= 用 户 名 不 能 为 空 

username.not.illegal= 用 户 名 错误 ， 必 须 以 字母 开头 ， 只 能 出 现 字 母 、 数 字 、 下 划 线 ， 并 且 长 度 在 5-20 之 间 
username .forbidden= 用 户 名 中 包含 非法 关键 词 【{0}】 

password.not.illegal= 密 码 长 度 必须 在 5-20 之 问 


(4、 视 图 页 面 (/WEB-INF/jsp/registerAndValidatorjsp ) 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 
<form:form commandName="Uuser"> 


<form:errors path="*" cssStyle="color:red"></form:errors><br/> 
username:<form:input path="username"/> 

<form:errors path="username" cssStyle="color:red"></form:errors> 
<br/> 

password:<form:password path="password"/> 

<form:errors path="password" cssStyle="color:red"></form:errors> 
<br/> 


<input type="submit" value=" 注 册 "/> 
</form:form> 


form:errors path=”"sername”_ : 表示 只 显示 username 字 段 的 错误 信息 ; 
(5、 测 试 


地 址 : http://localhost:9080/springmvc-chapter4/validator 


用 户 名 中 包含 非法 关键 词 【admin] 
密码 长 度 几 须 在 5-20 之 间 
username: [admin123 用 户 名 中 包含 非法 关键 词 【admin] 


password: | 密码 长 度 必 须 在 5-20 之 间 


注册 


当 我 们 输入 错误 的 数据 后 ， 会 报错 (form:errors path=”" 显 示 所 有 错误 信息 ， 而 form:errors 
path="wsername" 只 显示 该 字段 相关 的 ) 。 

问题 : 

如 MultiActionController 控 制 器 相关 方法 没有 提供 给 我 们 errors 对 象 (Errors) ， 我 们 应 该 怎么 
生 行 错误 处 理 呢 ? 

此 处 给 大 家 一 个 思路 ，errors 本 质 就 是 一 个 Errors 接 口 实现 ， 而 且 在 页 面 要 读 取 相关 的 错误 对 
象 ， 该 错误 对 象 应 该 存放 在 模型 对 象 里 边 ， 因 此 我 们 可 以 自己 创建 个 errors 对 象 并 将 其 添加 到 
模型 对 象 中 即 可 。 


此 处 我 们 复制 4.15 节 的 UserController 类 为 UserAndValidatorController， 并 修改 它 的 
create (新 增 ) 方法 添加 如 下 代码 片段 : 


BindException errors = new BindException(user, getCommandName(user)); 
// 如 果 用 户 名 为 空 
if(!StringUtils.hasLength(user.getUsername())) { 


errors.rejectValue("username", "username.not.empty"); 


if(errors.hasErrors()) { 
return new ModelAndView(getCreateView()).addAllObjects(errors.getModel()); 
} 


ynew BindException(user, getCommandName(user)) : 使 用 当前 的 命令 对 象 ， 和 命令 对 
象 的 名 字 创 建 了 一 个 BindException 作 为 errors ; 


VStringUtils.hasLength(usergetUsername()) : 如 果 用 户 名 为 空 就 是 用 
errors.rejectValue("username", "username.not.empty"); 注 入 错误 码 ; 


Verrors.hasErrors() : 表示 如 果 有 错误 就 返回 到 新 增 页 面 并 显示 错误 消息 


VModelAndView(getCreateView()).addAllObjects(errors.getModel()) : 此 处 一 定 把 errors 
对 象 的 模型 数据 放 在 当前 的 ModelAndView 中 ， 作 为 当前 请 求 的 模型 数据 返回 


在 浏览 器 地 址 栏 输入 : http://localhost:9080/springmvc-chapter4/userAndValidator/create 到 
新 增 页 面 


用 户 名 不 能 为 补 
用 户 名 ， | 
真实 姓名 ,| 


新 增 
用 户 名 什么 都 不 输入 ， 提 交 后 又 返回 到 新 增 页 面 而 且 显示 了 错误 消息 说 明 我 们 的 想法 是 正确 
的 。 
4.16.2.4.2、 声 明 式 验证 器 


从 Spring3 开 始 支 持 JSR-303 验 证 框架 ， 支 持 XML 风 格 和 注解 风格 的 验证 ， 目 前 在 
@RequestMapping 时 才能 使 用 ， 也 就 是 说 基于 Controller 接 口 的 实现 不 能 使 用 该 方式 (但 可 以 
使 用 编程 式 验证 ， 有 需要 的 可 以 参考 hibernate validator 实 现 ) ， 我 们 将 在 第 七 章 详细 介绍 。 


到 此 Spring2 风 格 的 控制 器 我 们 就 介绍 完了 ， 以 上 控制 器 从 spring3.0 开 始 已 经 不 推荐 使 用 了 
(但 考虑 到 还 有 部 分 公司 使 用 这 些 @Deprecated 类 ， 在 此 也 介绍 了 一 下 ) ， 而 是 使 用 注解 控 
制 器 实现 (@Controller 和 @RequestMapping) 。 


私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com) 


原创 内 容 ， 转 载 请 注 明 私 熟 在 线 【http://sishuok.com/forum/blogPost/list/5837.html]】 


第 五 草 处 理 器 拦截 器 详解 一 一 跟着 开 涛 学 
SpringMVC 


5.1、 处 理 器 拦截 器 简介 


Spring Web MVC 的 处 理 器 拦截 器 〈 如 无 特殊 说 明 ， 下 文 所 说 的 拦截 器 即 处 理 器 拦截 器 ) 


类 似 于 Servlet 开 发 中 的 过 滤器 Filter， 用 于 对 处 理 器 进行 预 处 理 和 后 处 理 。 


5.1.1、 第 见 应 用 场景 
1、 日 志 记 录 : 记录 请 求 信息 的 日 志 ， 以 便 进 行 信息 监控 、 信 息 统计 、 计 算 PV (Page View) 等 。 
2、 权 限 检 查 : `` 如 登录 检测 ， 进 入 处 理 器 检测 检测 是 否 登 录 ， 如 果 没 有 直接 返回 到 登录 页 面 ; 
3、 性 能 监控 : `` 有 时 候 系统 在 某 段 时 间 英 名 其 妙 的 慢 ， 可 以 通过 拦截 器 在 进入 处 理 器 之 前 记录 开始 时 间 ， 在 处 理 完 后 记录 : 
4、 通 用 行为 :“` 读 取 cookie 得 到 用 户 信息 并 将 用 户 对 象 放 入 请 求 ， 从 而 方便 后 续 流程 使 用 ， 还 有 如 提取 Locale、Theme 
5、0penSessionInView :“` 如 Hibernate， 在 进入 处 理 器 打开 Session， 在 完成 后 关闭 Session。 


ee 本 质 也 是 AOP (面向 切面 编程 ) ， 也 就 是 说 符合 横 切 关注 点 的 所 有 功能 都 可 以 放 入 拦 鹤 器 实现 。 
关 起 张 地 
5.1.2、 拦 截 器 接口 


package org.springframework.web.servilet; 
public interface HandlerInterceptor { 
boolean preHandle( 
HttpServletRequest request, HttpServletResponse response, 
Object handler) 
throws Exception; 


void postHandle( 
HttpServletRequest request, HttpServletResponse response, 
Object handler, ModelAndView modelAndView) 
throws Exception; 


void afterCompletion( 
HttpServletRequest request, HttpServletResponse response, 


Object handler, Exception ex) 
throws Exception; 


我 们 可 能 注意 到 拦截 器 一 个 有 3 个 回调 方法 ， 而 一 般 的 过 滤器 Filter 才 两 个 ， 这 是 怎么 回 事 呢 ? 马上 分 析 。 


preHandle : 预 处 理 回 调 方法 ， 实 现 处 理 器 的 预 处 理 (如 登录 检查 ) ， 第 三 个 参数 为 响应 的 处 
(如 我 们 上 一 章 的 Controller 实 现 ) ; 


返回 值 : true 表 示 继 续 流程 (如 调用 下 一 个 拦截 器 或 处 理 器 ) ; 


false 表 示 流 程 中 断 (如 登录 检查 失败 ) ， 不 会 继续 调用 其 他 的 拦截 器 或 处 理 器 ， 此 时 我 们 需 
要 通过 response 来 产生 响应 ; 


postHandle : 后 处 理 回 调 方 法 ， 实 现 处 理 器 的 后 处 理 〈 但 在 泻 染 视图 之 前 ) ， 此 时 我 们 可 以 
通过 modelAndView (模型 和 视图 对 象 ) 对 模型 数据 进行 处 理 或 对 视图 进行 处 理 ， 
modelAndView 也 可 能 为 null 。 


afterCompletion : 整个 请 求 处理 完 毕 回 调 方法 ， 即 在 视图 泻 业 完毕 时 回调 ， 如 性 能 监控 中 我 
们 可 以 在 此 记录 结束 时 间 并 输出 消耗 时 间 ， 还 可 以 进行 一 些 资源 清理 ， 类 似 于 try-catch-finally 
中 的 finally， 但 仅 调 用 处 理 器 执行 链 中 preHandle 返 回 true 的 拦截 器 的 afterCompletion。 


5.1.3、 拦 截 器 适配器 


有 时 候 我 们 可 能 只 需要 实现 三 个 回调 方法 中 的 某 一 个 ， 如果 实现 Handlerlnterceptor 接 口 的 话 ， 三 个 方法 必 
须 实 现 ， 不 管 你 需 不 需要 ， 此 时 spring 提 供 了 一 个 HandlerlnterceptorAdapter 适 配器 (一 种 适 
配器 设计 模式 的 实现 ) ， 允 许 我 们 只 实现 需要 的 回调 方法 。 


public abstract class HandlerIinterceptorAdapter implements HandlerInterceptor { 
// 省 略 代码 此 处 所 以 三 个 回调 方法 都 是 空 实现 ，preHandle 返 回 true。 
} 


5.1.4、 运 行 流程 图 





HandlerIinterceptoll .preHandle 、 返 回 uue 继 续 流程 


HandlerIinterceptop .preHandle 
2、 返 加 rue 稚 续 流程 


HandleraAdapter 


图 5-1 正常 流程 













、 返 回 bue 继 续 流程 


HandleLrInteLrcepto3B .preHandle 
HandlerIinterceptomM.preHandle 


HandleraAdapter 
HandlerIinterceptoM.postHandle 


HandlerIinterceptoumM.afterCompletion 


HandlerIinterceptoB.afterCompletion 


图 5-2 中 断 流程 


中 断 流程 中 ， 比 如 是 Handlerlnterceptor2 中 断 的 流程 (preHandle 返 回 false) ， 此 处 仅 调用 它 
之 前 拦截 器 的 preHandle 返 回 true 的 afterCompletion 方 法 。 


接 下 来 看 一 下 DispatcherServ1Let 内 部 到 底 是 如 何 工作 的 吧 : 


//doDispatch 方 法 
//1、 处 理 器 拦截 器 的 预 处 理 ( 正 序 执行 ) 
HandlerIinterceptor[] interceptors = mappedHandler .getIinterceptors(); 
If (interceptors != nul1) { 
for (int i = 0; i < interceptors.length; I++) { 
HandlerInterceptor interceptor = interceptors[i]; 
if (!interceptor.preHandle(processedRequest, response, mappedHandler .getHandler() 
//1.1、 失 败 时 触发 afterCompletion 的 调用 
triggerAfterCcompletion(mappedHandler, interceptorIindex, processedRequest, res 
return; 
} 
interceptorIndex = i;//1.2、 记 录 当 前 预 处 理 成 功 的 索引 
} 


} 
//2、 处 理 器 适配器 调用 我 们 的 处 理 器 
mv = ha.handle(processedRequest, response, mappedHandler .getHandler()); 
// 当 我 们 返回 null 或 没有 返回 逻辑 视图 名 时 的 默认 视图 名 翻译 (详解 4,15.5 RequestToViewNameTranslator) 
if (mv != null && !mv.hasView()) { 
mv.setViewName(getDefaultViewName(request)); 


} 

//3、 处 理 器 拦截 器 的 后 处 理 (逆序 ) 

If (interceptors != nul1) { 

for (int i = interceptors.length - 1; i >= 0; i--) { 
HandlerInterceptor interceptor = interceptors[i]; 
interceptor.postHandle(processedRequest, response, mappedHandler .getHandler(), mv); 


} 


} 
//4、 视 图 的 演 染 
if (mv != Null && !mv.wasCleared()) { 
render(mv, processedRequest, response); 
if (errorView) { 
WebUtils.clearErrorRequestAttributes(request); 


} 
//5、 和 触发 整个 请 求 处 理 完 毕 回调 方法 aftercompletion 
triggerAfterCompletion(mappedHandler, interceptorIndex, processedRequest, response, null) 


i 


注 : 以 上 是 流程 的 简化 代码 ， 中 间 省 略 了 部 分 代码 ， 不 完整 。 





// triggerAfterCompletion 方 法 
private void triggerAfterCompletion(HandlerExecutionChain mappedHandler, int interceptorI 
HttpServletRequest request, HttpServletResponse response, Exception ex) throw 
// 5、 触 发 整个 请 求 处 理 完毕 回调 方法 afterCompletion (逆序 从 1.2 中 的 预 处 理 成 功 的 索引 处 的 拦截 器 技 
if (mappedHandler != null) { 
HandlerInterceptor[] interceptors = mappedHandler .getInterceptors(); 
if (interceptors != null) { 
for (int i = interceptorIindex; i >= 0; i--) { 
HandlerInterceptor interceptor = interceptors[i]; 
try { 
interceptor.afterCompletion(request, response, mappedHandler .getH 


} 
catch (Throwable ex2) { 

logger .error("HandlerIinterceptor.afterCompletion threw exception" 
} 





5.2`“、 和 入门 


具体 内 容 详 见 工程 springmvc-chapter5。 


package cn.javass.chapters.web.interceptor; 


// 省 略 import 
public class HandlerInterceptor1 extends HandlerInterceptorAdapter {// 此 处 一 般 继 承 HandlerIn 
Q@Override 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Ob 
System.out.println("===========HandlerInterceptor1 preHandle"); 
return true; 
} 
@Override 
public void postHandle(HttpServletRequest request, HttpServletResponse response, Obje 
System.out.println("===========HandlerInterceptor1 postHandle"); 
} 
Q@Override 
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
System.out,println("===========HandlerInterceptor1 afterCompletion"); 
} 





以 上 是 Handlerlnterceptor1 实 现 ，Handlerlnterceptor2 同 理 只 是 输出 内 容 
为 “Handlerlnterceptor2”。 


(2、 控 制 器 


package cn.javass,chapter5 .web.controller ; 
// 省 略 import 
public class TestController implements Controller { 
Q@Override 
public ModelAndView handleRequest(HttpServletRequest req, HttpServletResponse resp) t 
System.out.println("===========TestController"); 
return new ModelAndView("test"); 





(3、Spring 配 置 文件 chapter5-servlet.xml 


<bean name="/test" class="cn.javass.chapter5.web.controller.TestController"/> 
<bean id="handlerIinterceptor1" 
class="cn.javass.chapter5.web.interceptor.HandlerInterceptor1"/> 

<bean id="handlerIinterceptor2" 
class="cn.javass.chapter5.web.interceptor.HandlerIinterceptor2"/> 


<bean class="org.springframework.web.servlet.handler .BeanNameUrlHandlerMapping"> 
<property name="interceptors"> 
<list> 
<ref bean="handlerIinterceptor1"/> 
<ref bean="handlerIinterceptor2"/> 
</list> 
</property> 
</bean> 


interceptors : 指定 拦截 器 链 ， 拦 截 器 的 执行 顺序 就 是 此 处 添加 拦截 器 的 顺序 ; 


(4、 视 图 页 面 WEB-INF/jsp/test.jsp 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<%System.out.printin("==========test .jsp");%> 
test page 


在 控制 台 输出 test.jsp 
(5、 启 动 服务 器 测试 


输入 网 址 : http:Wlocalhost:9080/springmvc-chapter5/test 


===========HandlerInterceptor1 preHandle 
===========HandlerInterceptor2 preHandle 

=== ==TestController 

=HandlerInterceptor2 postHandle 

=== ==HandlerInterceptor1 postHandle 

三 三 三 三 三 = 三 二 三 St j sp 

=== ==HandlerInterceptor2 afterCompletion 
===========HandlerInterceptor1 afterCompletion 









到 此 一 个 正常 流程 的 演示 完毕 。 和 图 5-1 一 样 ， 接 下 来 看 一 下 中 断 的 流程 。 


5.2.2、 中 断 流程 
(1、 拦 截 器 


Handlerlnterceptor3 和 Handlerlnterceptor4 与 之 前 的 Handlerlnteceptor1 和 
Handlerlnterceptor2 一 样 ， 只 是 在 Handlerlnterceptor4 的 preHandle 方 法 返回 false : 


Q@override 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Ob 
System.out.println("===========HandlerInterceptor1 preHandle"); 


response.getwriter().print("break");// 流 程 中 断 的 话 需 要 我 们 进行 响应 的 处 理 
return false;// 返 回 false 表 示 流 程 中 断 
} 


I | 


(2、 控 制 器 





流程 中 断 不 会 执行 到 控制 器 ， 使 用 之 前 的 TestController 控 制 器 。 
(3、Spring 配 置 文件 chapter5-servlet.xml 


<bean id="handlerIinterceptor3" 
class="cn.javass.chapter5.web.interceptor.HandlerIinterceptor3"/> 
<bean id="handlerIinterceptor4" 
class="cn.javass.chapter5.web.interceptor.HandlerIinterceptor4"/> 


<bean id="handlerIinterceptor3" 
class="cn.javass.chapter5.web.interceptor.HandlerIinterceptor3"/> 
<bean id="handlerIinterceptor4" 
class="cn.javass.chapter5.web.interceptor.HandlerIinterceptor4"/> 


<bean class="org.springframework.web.servlet.handler .BeanNameUrlHandlerMapping"> 
<property name="interceptors"> 
<list> 
<ref bean="handlerIinterceptor3"/> 
<ref bean="handlerIinterceptor4"/> 
</list> 
</property> 
</bean> 


interceptors : 指定 拦截 器 链 ， 拦 截 器 的 执行 顺序 就 是 此 处 添加 拦截 器 的 顺序 ; 
(4、 视 图 页 面 

流程 中 断 ， 不 会 执行 到 视图 泻 染 。 

(5、 启 动 服务 器 测试 


输入 网 址 : http:Wlocalhost:9080/springmvc-chapter5/test 


===========HandlerInterceptor3 preHandle 
===========HandlerInterceptor4 preHandle 
===========HandlerInterceptor3 afterCompletion 


此 处 我 们 可 以 看 到 只 有 Handlerinterceptor3 的 afterCompletion 执 行 ， 否 和 图 5-2 的 中 断 流程 。 


而 且 页 面 上 会 显示 我 们 在 Handlerlnterceptor4 preHandle 直接 写 出 的 响应 “break"”。 
5.3、 应 用 


5.3.1、 性 能 监控 


如 记录 一 下 请 求 的 处 理 时 间 ， 得 到 一 些 慢 请 求 〈《 如 处 理 时 间 超过 500 毫 秒 ) ， 从 而 进行 性 能 改 
进 ， 一 般 的 反 向 代理 服务 器 如 apache 都 具有 这 个 功能 ， 但 此 处 我 们 演示 一 下 使 用 拦截 器 怎么 
实现 。 


1、 在 进入 处 理 器 之 前 记录 开始 时 间 ， 即 在 拦截 器 的 preHandle 记 录 开 始 时 间 ; 


2、 在 结束 请 求 处 理 之 后 记录 结束 时 间 ， 即 在 拦截 器 的 afterCompletion 记 录 结 束 实 现 ， 并 用 结 
束 时 间 - 开 始 时 间 得 到 这 次 请 求 的 处 理 时 间 。 


问题 : 


我 们 的 拦截 器 是 单 例 ， 因 此 不 管用 户 请 求 多 少 次 都 只 有 一 个 拦截 器 实现 ， 即 线程 不 安全 ， 那 
我 们 应 该 怎么 记录 时 间 呢 ? 


解决 方案 是 使 用 ThreadLocal， 它 是 线程 绑 定 的 变量 ， 提 供 线 程 局 部 变量 (一 个 线程 一 个 
ThreadLocal， 人 AA 线程 的 ThreadLocal 只 能 看 到 人 线程 的 ThreadLocal ， 不 能 看 到 B 线 程 的 
ThreadLocal) 。 


代码 实现 : 


package cn.javass.chapter5s.web.interceptor; 
public class StopwatchHandlerIinterceptor extends HandlerInterceptorAdapter { 
private NamedThreadLocal<Long> startTimeThreadLocal = 
new NamedThreadLocal<Long>("Stopwatch-startTime"); 
Q@Override 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, 
Object handler) throws Exception { 
long beginTime = System.currentTimeMillis();//1、 开 始 时 间 
startTimeThreadLocal.set(beginTime);// 线 程 绑 定 变量 (该 数据 只 有 当前 请 求 的 线程 可 见 ) 
return true;// 继 续 流程 


} 


Q@Override 
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
Object handler, Exception ex) throws Exception { 
long endTime = System.currentTimeMillis();//2、 结 束 时 间 
long beginTime = startTimeThreadLocal.get();// 得 到 线程 绑 定 的 局 部 变量 (开始 时 间 ) 
long consumeTime = endTime - beginTime;//3、 消 耗 的 时 间 
if(consumeTime > 500) {// 此 处 认为 处 理 时 间 超 过 509 毫 秒 的 请 求 为 慢 请 求 
//T0DO 记录 到 日 志文 件 
System.out.println( 
String.format("%s consume %d millis", request.getRequestURI(), consumeTime)); 


} 
} 
} 
二 "| 
NamedThreadLocal : Spring 提 供 的 一 个 命名 的 ThreadLocal 实 现 。 
在 测试 时 需要 把 stopWatchHandlerlnterceptor 放 在 拦截 器 链 的 第 一 个 ， 这 样 得 到 的 时 间 才 是 
比较 准确 的 。 
5.3.2、 和 有 登录 检测 
在 访问 某 些 资源 时 〈 如 订单 页 面 ) ， 需 要 用 户 登 录 后 才能 查看 ， 因 此 需要 进行 登录 检测 。 
流程 : 
1、 访 问 需要 登录 的 资源 时 ， 由 拦截 器 重 定向 到 登录 页 面 ; 
2、 如 果 访 问 的 是 登录 页 面 ， 拦 截 器 不 应 该 拦截 ; 


3、 用 户 登 录 成 功 后 ， 往 cookie/session 添 加 登录 成 功 的 标识 (如 用 户 编号 ) ; 


4、 下 次 请 求 时 ， 拦 截 器 通过 判断 cookie/session 中 是 否 有 该 标识 来 决定 继续 流程 还 是 到 登录 
页 面 ; 


5、 在 此 拦截 器 还 应 该 允许 游客 访问 的 资源 。 


拦截 器 代码 如 下 所 示 : 


Q@override 
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, 
Object handler) throws Exception { 
//1、 请 求 到 登录 页 面 放行 
if(request.getServletPpath().startswith(loginUr1l)) { 
return true; 
} 


//2、TODO 比如 退出 、 首 页 等 页 面 无 需 登 录 ， 即 此 处 要 放行 允许 游客 的 请 求 


//3、 如 果 用 户 已 经 登录 放行 
if(request.getSession().getAttribute("username") != null) { 
// 更 好 的 实现 方式 的 使 用 cookie 
return true; 


} 


//4、 非 法 请 求 即 这 些 请 求 需要 登录 后 才能 访问 

// 重 定向 到 登录 页 面 
response.sendRedirect(request.getContextPath() + loginUr1); 
return false; 





提示 : 推荐 能 使 用 servlet 规 范 中 的 过 滤器 Filter 实 现 的 功能 就 用 Filter 实 现 ， 因 为 
Handlerlnteceptor 只 有 在 Spring Web MVC 环 境 下 才能 使 用 ， 因 此 Filter 是 最 通用 的 、 最 先 应 该 
使 用 的 。 如 登录 这 种 拦截 器 最 好 使 用 Filter 来 实现 。 
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第 四 章 Controller 接 口 控制 器 详解 (5) 一 一 跟着 开 涛 学 
SpringMVC 
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注解 式 控 制 | 劳 运 和 J 流程 及 处 理 器 二 2 草 注解 式 


控制 器 详解 





跟着 开 涛 学 SpringMVC 


声明 : 本 系列 都 是 原创 内 容 ， 觉 得 好 就 顶 一 个 ， 让 更 多 人 知道 ! ! 希望 那些 躁 的 人 给 出 不 好 
的 理由 ， 我 会 积极 改正 。 写 博客 不 容易 ， 写 原创 更 不 容易 1 1 


6.1、 注 解 式 控制 


器 简介 


** 一 、Spring2.5 之 前 ， 我 们 都 是 通过 实现 Controller 接 口 或 其 实现 来 定义 我 们 的 处 理 器 类 。 已 经 @Deprecated。** 


* 二 、Spring2.5 引 入 注解 式 处 理 器 支持 ， 通 过 @Controller 和 @RequestMapping 注 解 定 义 我 们 的 处 理 器 类 。** 


** 并 且 提 供 了 一 组 强大 的 注解 : ** 


需要 通过 处 理 器 映射 DefaultAnnotationHandlerMapping 和 处 理 器 适配器 


到 


AnnotationMethodHandlerAdapter 来 开启 支持 @Controller 和 


@RequestMapping 注 解 的 处 理 器 。 


@Controller : ` 用 于 标识 是 处 理 器 类 ; 


@RequestMapping :“ 
@RedquestParam : 


QModelAttribute: 


` 请 求 到 处 理 器 功能 方法 的 映射 规则 ; 
` 请 求 参 数 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ; 


` 请 求 参数 到 命令 对 象 的 绑 定 ; 


@SessionAttributes : ` 用 于 声明 session 级 别 存储 的 属性 ， 放 置 在 处 理 器 类 上 ， 通 常 列 出 


模型 属性 (如 @ModelAttribute)`` 对 应 的 名 称 ， 则 这 些 属 性 会 透明 的 保存 到 session 中 ; 


@InitBinder: 


“ 自 定义 数据 绑 定 注册 支持 ， 用 于 将 请 求 参数 转换 到 命令 对 象 属性 的 对 应 类 型 ; 


** 三 “Spring3.0 引 入 RESTfu1 架 构 风格 支持 (通过 @PathVariab1le 注 解 和 一 些 其 他 特性 支持 ) ， 且 又 引入 了 ** 


** 更 多 的 注解 支持 : ** 


Q@CooklieVvalue : 
@RequestHeader : 
@RequestBody : 


@ResponseBody : 


@ResponseStatus : 


`“cookie 数 据 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ; 


请求 头 《header ) 数据 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ; 


` 请 求 的 body 体 的 绑 定 (通过 HttpMessageConverter 进 行 类 型 转换 ) ; 


` 处 理 器 功能 处 理 方法 的 返回 值 作为 响应 休 (通过 HttpMessageConverter 进 行 类 型 转换 ) ; 


“定义 处 理 器 功能 处 理 方法 /异常 处 理 器 返回 的 状态 码 和 原因 ; 





@ExceptionHandler : ”注解 式 声 明 异 常 处 理 器 ; 


Q@PathVvVariable : 


“请求 URI 中 的 模板 变量 部 分 到 处 理 器 功能 处 理 方法 的 方法 参数 上 的 绑 定 ， 


从 而 支持 RESTful 架 构 风 格 的 URI ; 


*x 四 、Spring3.1 使 用 新 的 HandlerMapping 和 HandlerAdapter 来 支持 @Contoller 和 @RequestMapping** 
** 注 解 处 理 器 。** 


新 的 @Contoller 和 @RequestMapping 注 解 支持 类 : 处 理 器 映射 RequestMappingHandlerMapping 


和 处 理 器 适配器 RequestMappingHandlerAdapter 组 合 来 代替 Spring2.5 开 始 的 处 理 器 映射 
DefaultAnnotationHandlerMapping 和 处 理 器 适配器 AnnotationMethodHandlerAdapter ， 


提供 更 多 的 扩展 点 。 


接 下 来 ， 我 们 一 起 开始 学 习 基 于 注解 的 控制 器 吧 。 

@、@、@ 一 般 是 可 变 的 ， 因 此 我 们 可 以 这 些 信 息 进行 请 求 到 处 理 器 的 功能 处 理 方法 的 映射 ， 
因此 请 求 的 映射 分 为 如 下 几 种 : 

URL 路 径 映射 : 使 用 URL 映 射 请 求 到 处 理 器 的 功能 处 理 方法 ; 

请 求 方法 映射 限定 : 如 限定 功能 处 理 方法 只 处 理 GET 请 求 ; 

请 求 参 数 映射 限定 : 如 限定 只 处 理 包 含 “abc” 请 求 参数 的 请 求 ; 

请 求 头 映射 限定 : 如 限定 只 处 理 *Accept=application/json” 的 请 求 。 


接 下 来 看 看 具体 如 何 映射 吧 。 


6.2™ 入 | 
** (1、 控 制 器 实现 ** 


package cn.javass.chapter6.web.controller; 


// 省 略 import 
@controller // 或 @RequestMapping //Q 中 将 一 个 POJO 类 声明 为 处 理 器 
public class HelloworldController { 

@RequestMapping(value = "/hello") //G) 请 求 URL 到 处 理 器 功能 处 理 方法 的 映射 


public ModelAndView helloworld() { 
//1、 收 集 参数 
//2、 绑 定 参 数 到 命令 对 象 
//3、 调 用 业务 对 象 
//4、 选 择 下 一 个 页 面 
ModelAndView mv = new ModelAndView( ); 
// 添 加 模型 数据 可 以 是 任意 的 POJO 对 象 
mv.addobject("message", "Hello World!"); 
// 设 置 逻 辑 视图 名 ， 视 图 解析 器 会 根据 该 名 字 解 析 到 具体 的 视图 页 
mv.SetViewName("he11o") ， 
return mv; //03 模型 数据 和 逻辑 视图 名 


有 EdE 双 
可 以 通过 在 一 个 POJO 类 上 放置 @QController 或 @QRequestMapping， 即 可 把 一 个 POJO 类 变 身 为 处 理 器 ; 
@RequestMapping(value = "/hello") `` 请 求 URL(/hello) 到 处 理 器 的 功能 处 理 方法 的 映射 ; 


模型 数据 和 逻辑 视图 名 的 返回 


现在 的 处 理 器 无 需 实现 /继承 任何 接口 /类 ， 只 需要 在 相应 的 类 /方法 上 放置 相应 的 注解 说 明 下 即 可 ， 
非常 方便 。 
(2、Spring 配 置 文件 chapter6-servlet.xml 


(2.1、HandlerMapping 和 HandlerAdapter 的 配置 


如 果 您 使 用 的 是 Spring3.,1 之 前 版 本 ， 开 启 注 解 式 处 理 器 支持 的 配置 为 : 


DefaultAnnotationHandlerMapping 和 AnnotationMethodHandlerAdapter 。 


<1!-Spring3.1 之 前 的 注解 HandlerMapping --> 
<bean 
class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping"/> 


<1!-Spring3.1 之 前 的 注解 HandlerAdapter --> 
<bean 
class='"org.springframework.web.servlet.mvc.annotation.AnnotatIionMethodHandJlerAdapter"/> 


到 二 一 sd 


如 果 您 使 用 的 Spring3.1 开 始 的 版 本 ， 建 议 使 用 RequestMappingHandlerMapping 和 
RequestMappingHandlerAdapter 。 


<1--Spring3.1 开 始 的 注解 HandlerMapping --> 

<bean 

class="org.springframework .web.servlet.mvc.method.annotation.RequestMappingHandlerMapping 
<1--Spring3.1 开 始 的 注解 HandlerAdapter --> 

<bean 

class="org.springframework .web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter 


本 IE 





下 一 章 我 们 介绍 DefaultAnnotationHandlerMapping 和 AnnotationMethodHandlerAdapter 

与 RequestMappingHandlerMapping 和 RequestMappingHandlerAdapter 的 区 别 。 

(2.2、 视 图 解析 器 的 配置 

还 是 使 用 之 前 的 org.springframework.web.servlet.view.InternalResourceViewResolver。 


(2.3、 处 理 器 的 配置 


<1-- 处 理 器 --> 
<bean class="cn.javass.chapter6.web.controller.HelloworldController"/> 


只 需要 将 处 理 器 实现 类 注册 到 Spring 配置 文件 即 可 ，Sspring 的 DefaultAnnotationHandlerMapping 或 RequestMapr 


能 根据 注解 @QController 或 @QRequestMapping 自 动 发 现 。 


(2.4、 视 图 页 面 (/WEB-INF/jsp/hello.jsp) 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN™" "http://www.w3.org/TR/html 
<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 

<title>Hello World</title> 

</head> 

<body> 

${message} 

</body> 

</html> 


剧 i 


${message} : 表示 显示 由 HelloWorldController 处 理 器 传 过 来 的 模型 数据 。 





(4、 启 动 服 务 器 测试 


地 址 栏 输 入 http://localhost:9080/springmvc-chapter6/hello， 我 们 将 看 到 页 面 显示 “Hello 
World”， 


表示 成 功 了 。 


整个 过 程 和 我 们 第 二 章 中 的 Hello World 类 似 ， 只 是 处 理 器 的 实现 不 一 样 。 接 下 来 我 们 来 看 一 
下 具体 流程 吧 。 


1、 发 送 请 求 
kitp:# 
localhos:9080/ 







Defaultnnnotation 
Hand] erMapping 





FrinenmYe. 
chapteré /hello HandlerExecutionChain 
ce : 
7、 返 pFy 
用 户 







nmnotatIionkethod 
Jst1lVi exr InternalResource Handl erndapter 
NYEB INFj sp'hallojsp ViewResolver 
和 第 二 章 唯一 不 同 的 两 处 是 : 
1、HandlerMapping 实 现 : 使 
用 DefaultAnnotationHandlerMapping (spring3.1 之 前 ) 或 RequestMappingHandlerMapping (spring3.1) 
蔡 换 之 前 的 BeanNameUrlHandlerMapping。 


注解 式 处 理 器 映射 会 扫描 spring 容 器 中 的 bean， 发 现 bean 实 现 类 上 拥有 


@controller 或 @QRequestMapping 注 解 的 bean， 并 将 它们 作为 处 理 器 。 


2、HandlerAdapter 实 现 : 使 用 AnnotationMeth odHandlerAdapter (spring3.1 之 前 ) 或 
RequestMappingHandlerAdapter (spring3.1) 替换 之 前 的 
SimpleControllerHandlerAdapter 。 


0° 


注解 式 处 理 器 适配器 会 通过 反射 调用 相应 的 功能 处 理 方法 (方法 上 拥 
有 @RequestMapping 注 解 ) 


好 了 到 此 我 们 知道 Spring 如 何 发 现 处 理 器 、 如 何 调用 处 理 的 功能 处 理 方 法 了 ， 接 下 来 我 们 


详细 学 习 下 如 何 定 义 处 理 器 、 如 何 进 行 请 求 到 功能 处 理 方法 的 定义 。 
6.4、 处 理 器 定义 


6.4.1、@Controller 


@Controller 
public class HelloworldController { 


推荐 使 用 这 种 方式 声明 处 理 器 ， 它 和 我 们 的 @Service、@Repository 很 好 的 对 应 了 我 们 常见 
的 三 层 开 发 架构 的 组 件 。 


6.4.2、@RequestMapping 


@RequestMapping 
public class HelloworldController { 


这 种 方式 也 是 可 以 工作 的 ， 但 如 果 在 类 上 使 用 @ RequestMapping 注 解 一 般 是 用 于 


窒 化 功能 处 理 方 法 的 映射 的 ， 详 见 6.4.3 。 


package cn.javass.chapter6.web.controller; 


@Controller 
@RequestMapping(value="/user") // 岂 处理 器 的 通用 映射 前 级 
public class HelloworldController2 { 
@RequestMapping(value = "/hello2") //@ 相 对 于 QD 处 的 映射 进行 窄 化 
public ModelAndView helloworld() { 
// 省 略 实现 
} 
} 


6.4.3、 罕 化 请 求 映 射 


package cn.javass.chapter6.web.controller; 


@Controller 
@RequestMapping(value="/user") /VD 处理 器 的 通用 映射 前 组 
public class HelloworldController2 { 
@RequestMapping(value = "/hello2") //@ 相 对 于 QD 处 的 映射 进行 窄 化 
public ModelAndView helloworld() { 
// 省 略 实 现 
} 
} 


@ 类 上 的 @RequestMapping(value="/user") 表示 处 理 器 的 通用 请 求 前 级 ; 
@ 处 理 器 功能 处 理 方法 上 的 是 对 @ 处 映射 的 罕 化 。 


此 http://localhost:9080/springmvc-chapter6/hello2 无 法 映射 到 HelloWorldController2 的 
helloWorld 功 能 处 理 方法 ; 而 http://localhost:9080/springmvc-chapter6/user/hello2 是 可 以 的 。 


http://localhost :90807springmvc-chapter6 |/user| |/hello2 


GCont roller 
GRequestMapping (value="/user") /7 中 处 理 器 的 通用 映射 前 缀 
public class HelloWorldController2 


@RequestMapping (value = "/hello2") /7@ 相 对 于 由 处 的 映射 进行 窜 化 
public ModelAndView helloWorldl) 1 


/7 省 略 实现 





窒 化 请 求 映 射 可 以 认为 是 方法 级 别 的 @RequestMapping 继 承 类 级 别 的 @RequestMapping。 


人 求 映 射 还 有 其 他 方式 ， 如 在 类 级 别 指定 URL， 而 方法 级 别 指定 请 求 方法 类 型 或 参数 等 


洲 


会 详 细 介 绍 o 


到 此 ， 我 们 知道 如 何 定义 处 理 器 了 ， 接 下 来 我 们 需要 学 习 如 何 把 请 求 映 射 到 相应 的 功能 处 理 
方法 


进行 请 求 处 理 。 


5、 请 求 映 射 


处 理 器 定义 好 了 ， 那 接 下 来 我 们 应 该 定义 功能 处 理 方法 ， 接 收 用 户 请 求 处 理 并 选择 视图 进行 


泻 染 。 


首先 我 们 看 一 下 图 6-1: 


系 万 |] 


跟 我 学 Spring 系列 


全 请 求 方法 加 请求 URL 图 协议 及 版 本 


POST http://localhost:9080/springmvc-chapter6/customers/create HTTP/1. 
Host: localhost:9080 

Connection; keep-alive 

Content-Length: 25 

Cache-Control: max-age=0 

Origin: http://localhost:9080 

User-Agent: Mozilla/5.0 (Windows NT 5.1) AppleWebKit/535.11 (KHTML., like Gecko) Chrome/17.0.963.83 Safari/535.11 
Content-Type: application/x-www-form-urlencoded 

Accept: text/html,application/xhtmil+*+xml,application/xml;q=0.,9,°/"*;q=0,.8 
Referer: http://localhost:9080/springmvc-chapter6/customers/create 
Accept-Encoding: gzip,deflate,sdch 

Accept-Language: zh-CN, eh q=0.8 

Accept-Charset: UTF-8,*;q= 655 

Cookie: JSESSIONID=91512BDE5A5EEFA7C44DAEEF6C20FC93 


《7 


Spring Wob MYC 


DispatcherServlet 


J 
处 理 器 (Controller) 


username=abc&password=123 











http 请 求 信 息 包 含 六 部 分 信息 : 。 


@D 请 求 方法 ， 如 GET 或 POST， 表 示 提 交 的 方式 ; 


(DURL ， 请 求 的 地 址 信息 ; 


(9) 协 议 及 版 本 ; 


(请 求 头 信息 (包括 Cookie 信 息 ) ; 


人 @) 回 车 换行 (CRLF) ; 


(6) 请 求 内 容 区 ( 即 请 求 的 内 容 或 数据 ) ， 如 表单 提交 时 的 参数 数据 、URL 请 求 参 数 (?abc=123 ?后 边 的 ) 等 。 


想 要 了 解 HTTP/1.1 协 议 ， 请 访问 [http://tools.ietf.org/html/rfc2616](http://tools.ietf.org/html/ 


[IAA 





那 此 处 我 们 可 以 看 到 有 CD、(C2、@ 由 、(@) 一 般 是 可 变 的 ， 因 此 我 们 可 以 这 些 信息 进行 请 求 到 


二 全 有 计 和 | 颈 渤 红 污 程 瑟 外表 绒 证 秒 二 音 注 饮 ;半角 于 
和 王 有 用 式 控 制 器 运行 流程 及 处 理 器 定义 第 六 和 草 注解 式 控 制 器 1 
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处 理 器 的 功能 处 理 方法 的 映射 ， 因 此 请 求 的 映射 分 为 如 下 几 种 : 


URL 路 径 映 射 : 使 用 URL 映 射 请 求 到 处 理 器 的 功能 处 理 方法 ; 

请 求 方法 映射 限定 : 如 限定 功能 处 理 方法 只 处 理 GET 请 求 ; 

请 求 参数 映射 限定 : 如 限定 只 处 理 包含 “abc” 请 求 参数 的 请 求 ; 

请 求 头 映射 限定 : 如 限定 只 处 理 “Accept=application/json” 的 请 求 。 
接 下 来 看 看 具体 如 何 映射 吧 。 

私 享 在 线 学 习 网 原创 内 容 (http://sishuok.com) 


原创 内 容 ， 转 载 请 注 明 私 享 在 线 【http://sishuok.com/forum/blogPost/list/0/6117.html] 


跟 我 学 Spring 系列 


源 代码 下 载 第 六 章 注解 式 控制 器 详解 
源 代码 请 到 附件 中 下 载 。 

其 他 下 载 : 

跟着 开 涛 学 SpringMVC 第 一 章 源 代码 下 载 

第 二 章 Spring MVC 入 门 源 代 码 下 载 


Controller 接 口 控制 器 详解 源 代码 下 载 


源码 下 载 一 一 第 四 章 Controller 接 口 控制 器 详解 一 一 跟着 开 涛 学 
SpringMVC 

源 代码 下 载 第 五 章 处 理 器 拦截 器 详解 一 一 跟着 开 涛 学 
SpringMVC 

目录 :[ 


第 一 章 Web MVC 简 介 
一 一 跟 开 涛 学 SpringMVC") 





A 


二 章 Spring MVC 入 门 一 一 跟 开 涛 学 SpringMVC 
第 三 章 DispatcherServlet 详 解 一 一 跟 开 涛 学 SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (1) 跟着 开 涛 学 
SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (2) 跟着 开 涛 学 
SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (3 ) 跟着 开 涛 学 
SpringMVC 


源 代 码 下 载 第 六 章 注解 式 控制 器 详解 


跟 开 涛 学 SpringMVC](Ublog/1593441 "第 一 章 Web MVC 简 介 
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跟 我 学 Spring 系列 


第 四 章 Controller 接 口 控制 器 详解 (4) 一 一 跟着 开 涛 学 
SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (5) 一 一 跟着 开 涛 学 
SpringMVC 


第 四 章 Controller 接 口 控制 器 详解 (6) 一 一 跟着 开 涛 学 
SpringMVC 


第 五 章 处 理 器 拦截 器 详解 一 一 跟着 开 涛 学 SpringMVC 


注解 式 控 睹 


1 器 运行 流程 及 处 理 器 定义 第 六 章 注解 式 控制 器 详解 
一 一 中 者 开 涛 学 S 


pringMVC 


源 代 码 下 载 第 六 章 注解 式 控制 器 详解 560 


SpringMVC3 强 大 的 请 求 映 射 规则 详解 第 六 章 注解 
式 控制 器 详解 一 跟着 开 涛 学 SpringMVC 


声明 : 本 系列 都 是 原创 内 容 ， 觉 得 好 就 顶 一 个 ， 让 更 多 人 知道 1 ! 写 博客 不 容易 ， 写 原创 更 
不 容易 1 |! 


6.5、 请 求 映 射 


处 理 器 定义 好 了 ， 那 接 下 来 我 们 应 该 定义 功能 处 理 方法 ， 接 收 用 户 请 求 处 理 并 选择 视图 进行 
泻 染 。 首 先 我 们 看 一 下 图 6-1: 


http 请 求 信息 包含 六 部 分 信息 : 

人 @D 请 求 方 法 ， 如 GET 或 POST， 表 示 提 交 的 方式 ; 

(OURL， 请 求 的 地 址 信息 ; 

G@@) 协 议 及 版 本 ; 

人 @ 请 求 头 信息 (包括 Cookie 信 息 ) ; 

回回 车 换行 (CRLF) ; 

(@ 请 求 内 容 区 ( 即 请 求 的 内 容 或 数据 ) ， 如 表单 提交 时 的 参数 数据 、URL 请 求 参 数 (?abc=123 ?后 边 的 ) 等 。 


想 要 了 解 HTTP/1.1 协 议 ， 请 访问 [http://tools.ietf.org/html/rfc2616] (http://tools.ietf.org/html/ 


A 





那 此 处 我 们 可 以 看 到 有 卜 、(G、 四 、(@) 一 般 是 可 变 的 ， 因 此 我 们 可 以 这 些 信息 进行 请 求 到 处 理 器 的 功能 处 理 方法 的 映射 ，| 
图 ee | 





URL 路 径 映 射 : 使 用 URL 映 射 请 求 到 处 理 器 的 功能 处 理 方法 ; 
请 求 方 法 映射 限定 : 如 限定 功能 处 理 方法 只 处 理 GET 请 求 ; 


请 求 参 数 映 射 限定 : 如 限定 只 处 理 包含 "abc" 请 求 参 数 的 请 求 ; 


请 求 头 映 射 限定 : 如 限定 只 处 理 “Accept=application/json” 的 请 求 。 
接 下 来 看 看 具体 如 何 映射 吧 。 


6.5.1、URL 路 径 映 射 


6.5.1.1、 普 通 URL 路 径 映 射 

@RequestMapping(value={"/test1", "/user/create")}) : 多 个 URL 路 径 可 以 映射 到 同一 个 处 理 器 
的 功能 处 理 方法 。 

6.5.1.2、URI 模 板 模 式 映射 


@RequestMapping(value="/users/{userld}》") : {xxx} 占 位 符 ， 请 求 的 URL 可 以 是 
“Jusers/123456” 或 


“Jusers/abcd”， 通 过 6.6.5 讲 的 通过 @PathVariable 可 以 提取 URI 模 板 模式 中 的 {xxx} 中 的 xxx 变 


号 - 
O 


里 


@RequestMapping(value="/users/{userld}/create") : 这 样 也 是 可 以 的 ， 请 求 的 URL 可 以 


日 


元“/Users/123/create”。 

@RequestMapping(value="/users/{userld}/topics/{topicld}") : 这 样 也 是 可 以 的 ， 请 求 的 URL 
可 以 是 “/users/123/topics/123”。 

6.5.1.3、Ant 风 格 的 URL 路 径 映 射 


@RequestMapping(value="/users/") : 可 以 匹配 “/users/abc/abc”， 但 “/users/123” 将 会 被 
【URI 模 板 模 式 映射 中 的 “/users/{userld}》” 模 式 优先 映射 到 】【 详 见 4.14 的 最 长 匹配 优先 
4 本 


@RequestMapping(value="/product?") : 可 匹配 “/product1” 或 “/producta”， 但 不 匹 
配 “/product” 或 “/productaa”; 


@RequestMapping(value="/product*") : 可 匹配 “/productabc” 或 “/product”， 但 不 匹 
配 “/productabc/abc”; 


@RequestMapping(value="/product/") : 可 匹配 /product/abc”， 但 不 匹配 </productabce”; 


@RequestMapping(value="/products/**/{productld}") : 可 匹 
配 “/products/abc/abc/123” 或 “/products/123”， 也 就 是 Ant 风 格 和 URI 模 板 变量 风格 可 混用 ; 


此 处 需要 注意 的 是 【4.14 中 提 到 的 最 长 匹配 优先 】，Ant 风 格 的 模式 请 参考 4.14。 


6.5.1.4、 正 则 表达 式 风格 的 URL 路 径 映 射 


从 Spring3.0 开 始 支持 正则 表达 式 风格 的 URL 路 径 映射 ， 格 式 为 { 变 量 名 :正则 表达 式 }， 这 样 我 
们 就 可 以 通过 6.6.5 讲 的 通过 @PathVariable 提 取 模 式 中 的 {xxx : 正则 表达 式 匹配 的 值 } 中 的 


xxx 变 量 了 。 


@RequestMapping(value="/products/{categoryCode:\d+}-{pageNumberi\d+}") : 可 以 匹 
配 “/products/123-1”， 但 不 能 匹配 “/products/abc-1”， 这 样 可 以 设计 更 加 严格 的 规则 。 


正则 表达 式 风格 的 URL 路 径 映 射 是 一 种 特殊 的 URI 模 板 模式 映射 : 
URI 模 板 模式 映射 是 {userld}， 不 能 指定 模板 变量 的 数据 类 型 ， 如 是 数字 还 是 字符 串 ; 


正则 表达 式 风 格 的 URL 路 径 映 射 ， 可 以 指定 模板 变量 的 数据 类 型 ， 可 以 将 规则 写 的 相当 复 


6.5.1.5、 组 合 使 用 是 “或 ”的 关系 


如 @RequestMapping(value={"/test1", "/user/create")}) 组 合 使 用 是 或 的 关系 ， 
即 “/test1” 或 “/user/create” 请 求 URL 路 径 都 可 以 映射 到 @RequestMapping 指 定 的 功能 处 理 方 
法 。 


以 上 URL 映 射 的 测试 类 为 : 
cn.javass.chapter6.web.controller.mapping.MappingController.java ° 


到 此 ， 我 们 学 习 了 Spring Web MVC 提 供 的 强大 的 URL 路 径 映 射 ， 而 且 可 以 实现 非常 复杂 的 
URL 规 则 。Spring Web MVC 不 仅仅 提供 URL 路 径 映 射 ， 还 提供 了 其 他 强大 的 映射 规则 。 接 下 
来 我 们 看 一 下 请 求 方法 映射 限定 吧 。 


6.5.2、 请 求 方法 映射 限定 

一 般 我 们 熟悉 的 表单 一 般 分 为 两 步 : 第 一 步 展 示 ， 第 二 步 提交 ， 如 4.9、 
SimpleFormController 那 样 ， 那 如 何 通过 @RequestMapping 来 实现 呢 ? 
6.5.2.1、 请 求 方法 映射 限定 


我 们 熟知 的 ， 展 示 表 单一 般 为 GET 请 求 方法 ; 提交 表单 一 般 为 POST 请 求 方法 。 但 6.5.1 节 讲 
的 URL 路 径 映 射 方 式 对 任意 请 求 方法 是 全 盘 接 受 的 ， 因 此 我 们 需要 某 种 方式 来 告诉 相应 的 功 
能 处 理 方法 只 处 理 如 GET 请 求 方 法 的 请 求 或 POST 请 求 方法 的 请 求 。 


接 下 来 我 们 使 用 @RequestMapping 来 实现 SimpleFormController 的 功能 吧 。 


package cn.javass.chapter6.web.controller.method; 


// 省 略 import 
@Controller | 
@RequestMapping("/customers/**") /VD 处 理 器 的 通用 映射 前 级 


public class RequestMethodController { 
@RequestMapping(value="/create", method = RequestMethod.GET)//@ 类 级 别 的 @RequestMappinc 
public String showForm() { 
System.out.println("===============GET" ); 
return "customer/create"; 


} 
@RequestMapping(value="/create", method = RequestMethod.POST)//(3) 类 级 别 的 @RequestMappir 
public String submit() { 

System.out.println("================POST"); 

return "redirect:/success"; 





@ 处 理 器 的 通用 映射 前 级 ( 父 路 径 ) : 表示 该 处 理 器 只 处 理 匹 配 “/customers/**” 的 请 求 ; 


@ 对 类 级 别 的 @RequestMapping 进 行 罕 化 ， 表 示 showForm 可 处 理 匹 
配 “/customers/*/create” 且 请 求 方法 为 ‘GET” 的 请 求 ; 


对 类 级 别 的 @RequestMapping 进 行 窜 化 ， 表 示 submit 可 处 理 匹 配 %/customers/**/create” 且 
请 求 方法 为 “POST" 的 请 求 。 
6.5.2.2、 组 合 使 用 是 “或 ”的 关系 


@RequestMapping(value="/methodOr", method = {RequestMethod.POST, 
RequestMethod.GE 信 ) : 即 请 求 方法 可 以 是 GET 或 POST。 


提示 : 


1、 一 般 浏览 器 只 支持 GET、POST 请 求 方法 ， 如 想 浏 览 器 支持 PUT、DELETE 等 请 求 方法 只 
能 模拟 ， 稍 候 章节 介绍 。 


2、 除 了 GET、POST ， 还 有 HEAD、OPTIONS、PUT 、DELETE、TRACE 。 
3、DispatcherServlet 默 认 开 启 对 GET、POST、PUT、DELETE、HEAD 的 支持 ; 


4、 如 果 需 要 支持 OPTIONS、TRACE ， 请 添加 DispatcherServlet 在 web.xml 的 初始 化 参数 : 
dispatchOptionsRequest 和 dispatchTraceRequest 为 true 。 


请 求 方法 的 详细 使 用 请 参考 RESTful 架 构 风 格 一 章 。 


以 上 请 求 方法 映射 限定 测试 类 为 : 
cn.javass.chapter6.web.controllermethod.RedquestMethodController 。 


6.5.3、 请 求 参数 数据 映射 限定 


6.5.3.1、 请 求 数据 中 有 指定 参数 名 


package cn.javass,chapter6,.web.controller.parameter ; 


// 省 略 import 
@Controller 
@RequestMapping("/parameter1") /VD 处 理 器 的 通用 映射 前 组 


public class RedquestParameterController1 { 
//G) 进 行 类 级 别 的 @RedquestMapping 宪 化 
@RequestMapping(params="create"，method=RedquestMethod .GET) 
public String ShowForm( ) { 
System.out,println("===============ShowForm'" ) ; 
return "parameter/create",; 
} 
//G@) 进 行 类 级 别 的 @RequestMapping 窒 化 
@RequestMapping(params="create", method=RequestMethod.POST) 
public String submit() { 
System.out.println("================SUbmit"); 
return "redirect:/success"; 


| 


@@RequestMapping(params="create", method=RequestMethod.GET) : 表示 请 求 中 
有 “create” 的 参数 名 且 请 求 方法 为 “GET” 即 可 匹配 ， 如 可 匹配 的 请 求 URL"http:// 
xxx/parameter1?create” ; 


@@RequestMapping(params="create", method=RequestMethod.POST) : 表示 请 求 中 
有 “create” 的 参数 名 且 请 求 方法 为 “POST” 即 可 匹配 ; 


此 处 的 create 请 求 参数 名 表示 你 请 求 的 动作 ， 即 你 想 要 的 功能 的 一 个 标识 ， 常 见 的 CRUD( 增 
删改 查 ) 我 们 可 以 使 用 如 下 请 求 参 数 名 来 表达 : 


CQ (create 请 求 参 数 名 且 GET 请 求 方法 ) 新 增 页 面 展 示 、 (create 请 求 参 数 名 且 POST 请 求 
方法 ) 新 增 提 交 ; 


(update 请 求 参 数 名 且 GET 请 求 方法 ) 新 增 页 面 展示 、 (update 请求 参 数 名 且 POST 请 
求 方法 ) 新 增 提交 ; 


@ (delete 请 求 参 数 名 且 GET 请 求 方法 ) 新 增 页 面 展示 、 (delete 请 求 参 数 名 且 POST 请 求 
方法 ) 新 增 提交 ; 


(query 请 求 参数 名 且 GET 请 求 方法 ) 新 增 页 面 展 示 、 (query 请 求 参数 名 且 POST 请 求 方 
法 ) 新 增 提交 ; 


@ (list 请 求 参数 名 且 GET 请 求 方法 ) 列表 页 面 展示 ; 
@ (view 请 求 参数 名 且 GET 请 求 方法 ) 查看 单条 记录 页 面 展 示 。 
6.5.3.2、 请 求 数据 中 没有 指定 参数 名 

// 请 求 参 数 不 包 含 create 参数 名 


@RequestMapping(params="!create",，method=RequestMethod.GET)// 进 行 类 级 别 的 @RequestMapping 窄 化 


了 | 








@ReduestMapping(params="lcreate", method=RequestMethod.GE7) : 表示 请 求 中 没 
有 “create” 参 数 名 且 请 求 方法 为 “GET” 即 可 匹配 ， 如 可 匹配 的 请 求 URL"http:;//xxx/parameter1? 
abc”° 


6.5.3.3、 请 求 数据 中 指定 参数 名 = 值 


package cn.javass.chapter6.web.controller .parameter; 





// 省 略 import 
@Controller | 
@RequestMapping("/parameter2") //( 由 处 理 器 的 通用 映射 前 级 


public class RequestParameterController2 { 
// 回 进行 类 级 别 的 @RequestMapping 窜 化 
@RequestMapping(params="submitFlag=create", method=RequestMethod .GET) 
public String showForm() { 
System.out.println("===============sShowForm"); 
return "parameter/create",; 
} 
//@@ 进 行 类 级 别 的 @RequestMapping 窜 化 
@RequestMapping(params="submitFlag=create", method=RequestMethod.POST) 
public String submit() { 
System.out.println("===============SUbmit"); 
return "redirect:/success",; 


@@RequestMapping(params="submitFlag=create", method=RequestMethod.GE7) : 表示 请 
求 中 有 “submitFlag=create” 请 求 参 数 且 请 求 方法 为 ‘GET”* 即 可 匹配 ， 如 请 求 URL 为 http:// 
xxx/parameter2?submitFlag=create ; 


@@RequestMapping(params="submitFlag=create", method=RequestMethod.POS7T) : 表示 
请 求 中 有 “submitFlag=create” 请 求 参数 且 请 求 方法 为 POST” 即 可 匹配 ; 


此 处 的 SubmitFlag=create 请 求 参 数 表示 你 请 求 的 动作 ， 即 你 想 要 的 功能 的 一 个 标识 ， 常 见 的 
CRUD( 增 删改 查 ) 我 们 可 以 使 用 如 下 请 求 参数 名 来 表达 : 


Q (submitFlag=create 请 求 参数 名 且 GET 请 求 方法 ) 新 增 页 面 展 示 、 (submitFlag=create 
请 求 参数 名 且 POST 请 求 方法 ) 新 增 提交 ; 


Q (submitFlag=update 请 求 参数 名 且 GET 请 求 方法 ) 新 增 页 面 展示 、 (submitFlag=update 
请 求 参数 名 且 POST 请 求 方法 ) 新 增 提交 ; 


Q (submitFlag=delete 请 求 参数 名 且 GET 请 求 方法 ) 新 增 页 面 展示 、 (submitFlag=delete 
请 求 参数 名 且 POST 请 求 方法 ) 新 增 提交 ; 


Q@ (submitFlag=query 请 求 参 数 名 且 GET 请 求 方法 ) 新 增 页 面 展示 、 (submitFlag=query 请 
求 参数 名 且 POST 请 求 方 法 ) 新 增 提 交 ; 


CQ (submitFlag=list 请 求 参数 名 且 GET 请 求 方法 ) 列表 页 面 展示 ; 


CQ (submitFlag=view 请 求 参 数 名 且 GET 请 求 方法 ) 查看 单条 记录 页 面 展示 。 


6.5.3.4、 请 求 数 据 中 指定 参数 名 != 值 


// 请 求 参数 submitFlag 不 等 于 create 
@RequestMapping(params="submitFlag!=create", method=RequestMethod.6GET) 


@RequestMapping(params="submitFlag!=create", method=RequestMethod.GE7) : 表示 请 
求 中 的 参数 "submitFlag!=create" 且 请 求 方法 为 "GET" 即 可 匹配 ， 如 可 匹配 的 请 求 URL“http:/ 
xxx/parameter1?submitFlag=abc” °。 


6.5.3.5、 组 合 使 用 是 “ 且 ” 的 关系 


@RequestMapping(params={"test1",， "test2=create"}) //@ 进 行 类 级 别 的 @RequestMapping 窜 化 


@RequestMapping(params={"test1", "test2=create")) : 表示 请 求 中 的 有 “test1” 参 数 名 且 
有 “test2=create” 参 数 即 可 匹配 ， 如 可 匹配 的 请 求 URL"http://xxx/parameter3? 
test1&test2=create 。 


以 上 请 求 参 数 数据 映射 限定 测试 类 为 : cn.javass.chapter6.web.controller.method 包 下 的 
RequestParameterController1 、RequestParameterController2、 
RequestParameterController3。 


6.5.4、 请 求 头 数据 映射 限定 

6.5.4.1、 准 备 环境 

浏览 器 : 建议 chrome 最 新 版 本 ; 

插件 : ModHeader 

安装 地 址 : https://chrome.google.com/webstore/detail/idgpnmonknjnojddfkpgkljpfnnfckjj 
插件 安装 步骤 : 

1、 打 开 https://chrome.google.com/webstore/detail/idgpnmonknjnojddfkpgkljpfnnfcklj ， 如 图 


6-2 


Wi ModHeader ED = 


妇女 让 女 庆 (15) 开发 人 员工 县 


图 6-2 


、 点 击 “ 添 加 至 chrome” 后 弹出 “确认 安装 ”对 话 框 ， 点 击 “ 安 装 ” 按 钮 即 可 ， 如 图 6-3: 


跟 我 学 Spring 系列 


要 安装 EodHeader 吗 ? 
它 可 掌握 以 下 信息 : 


' 您 在 所 有 网 站 上 的 数据 





图 6-3 
3、 人 安装 成 功 后 ， 在 浏览 器 右上 角 出 现 如 图 6-4 的 图 标 表示 安装 成 功 : 


| 二 委 AN 
示 私 亨 在 线 - 视 = 
有 odHeader 现 已 安装 完毕 。 Xx 


您 可 以 通过 点 击 “ 工 具 ” 菜 单 中 的 “扩展 程序 ” ee 
理 已 安装 的 由 展 程序 。 | 











图 6-4 
4、 和 鼠标 右 击 右上 角 的 “Modify Header" 图 标 ， 选 择 选项 ， 打 开 如 图 6-5 : 








多、 
fe Ne = em 一 、- 7 >» 
| Profile 1 Profile 2 Profile 3 Profile 4 = 

加 | 


Add Header 


Whitelisted domain =*//* 


图 6-5 


7、 修 改 完成 后 ， 输 入 URL 请 求 ， 你 可 以 在 chrome 的 “开发 人 员工 具 的 "网络 选项 卡 下 ， 看 到 如 
图 6-7 的 信息 表示 添加 请 求 头 成 功 了 : 


A 
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* by 1 
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Headers Preview Response Cookies Timing 


Kequest Method: GET 
Status Code: © 2808 OK 
vvRequest Headers VigW SOUrCe 
Accapt: text/html ,application/xhtml+xml ,application/xml ;9q=0.9,*/*;q=0.8 
Accaept-Charset: UTF-8,*;9Q=9.5 
Accapt-Encoding: eg 
Accapt-Laneuaze: zh-CN,zh;q=@.8 
Cache-Control: max- age=®© 
Connection: keep-alive 
Cookie: JSESSIONID=681BCF99239C3664F SFDE7COFCAG2E4AF 
Host: localhost :9686 


User—Agent - YS NT 5.1) AppleWebKit/535.11 (KHTML, like Gecko) 
和 加 了 请 求 六 | 


Request URL: http://localhost:990980/springemvc-chapteré/customers/create 


图 6-7 


到 此 我 们 的 工具 安装 完毕 ， 接 下 来 看 看 如 何 使 用 请 求 头 数据 进行 映射 限定 。 


6.5.4.2、 请 求 头 数 据 中 有 指定 参数 名 


@RequestMapping(value="/header/test1", headers = "Accept") : 表示 请 求 的 URL 必 须 
为 “</header/test1” 


且 请 求 头 中 必须 有 Accept 参 数 才能 匹配 。 


@RequestMapping(value="/header/test1", headers = "abc") : 表示 请 求 的 URL 必 须 
为 “/header/test1” 


且 请 求 头 中 必须 有 abc 参 数 才能 匹配 ， 如 图 6-8 时 可 匹配 。 
nN Se Scripts CM sineiine CN Proriies (auaits 下 Consoie 








Headerts Preview Ress 介 
一 一 -一 :一 一 < 信 一 ~ 一 一 ME 一 玫 
Reaquaest URL- http://loc: 
| a 避 2d Profile 1 Profile 2 Profile 3 Fis = || 
Status Code: 28 OK 
vReauecest Headers en (用 abc 123 omment > 


Accept: text/html ,oppl 

Accept-Charset: UTF-8, Add Header 
Accept-Bncoding: gzip, 

Accept-ianeuaze: zh-CN | Whitelisted domain *//* 
Cache~Control: max- age 

Connection: keep-alive 

Cookie: JSESSIONID=6818CF99239C38664F 8FOE7COFCAG2E4F 
Host: localhost :96836 


User—Agent: } ss NT S.1) AppleWebKit/S35.11 (KHTML, like Gecko) 
】 EE 光度 加 了 请 求 头 





图 6-8 
6.5.4.3、 请 求 头 数据 中 没有 指定 参数 名 


@RequestMapping(value="/header/test2", headers = "labc") : 表示 请 求 的 URL 必 须 
为 “/header/test2” 


思 A 
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且 请 求 头 中 必须 没有 abc 参 数 才 能 匹配 。 (将 Modify Header 的 abc 参 数值 删除 即 可 ) 。 


| Profile 1 Profile 2 Profile 3 Profile 4 | 


abc 123 入 
Add Header 


6.5.4.4、 请 求 头 数据 中 指定 参数 名 = 值 


@RequestMapping(value="/header/test3", headers = "Content-Type=application/json") : 表 
示 请 求 的 URL 必 须 为 “/header/test3” 且 请 求 头 中 必须 有 “Content-Type=applicatiomjson” 参 数 
即 可 匹配 。 (将 Modify Header 的 Content-Type 参 数值 改 为 “application/json” 即 可 ) ; 


Profile 1 Profile 2 Profile 3 Profile 4 
7 Content-Type application/}son 芒 


当 你 请 求 的 URL 为 “/header/test3” 但 如 果 请 求 头 中 没有 或 不 是 “Content- 
Type=application/json” 参 数 (如 "text/html" 其 他 参数 ) ， 将 返回 “HTTP Status 415” 状 态 码 【 表 
示 不 支持 的 媒体 类 型 (Media Type)， 也 就 是 MIME 类 型 】， 即 我 们 的 功能 处 理 方 法 只 能 处 理 
application/json 的 媒体 类 型 。 


@RequestMapping(value="/header/test4", headers = "Accept=application/json") : 表示 请 求 
的 URL 必 须 为 “/header/test4” 且 请 求 头 中 必须 有 “Accept =application/json” 参 数 即 可 匹配 。 
(将 Modify Header 的 Accept 参 数值 改 为 “application/json” 即 可 ) ; 
Ey WY EY RY No SE a 


Profile 1 Profile 2 Profile 3 Profile 4 


RF Accept application/json > 


当 你 请 求 的 URL 为 “header/test4” 但 如 果 请 求 头 中 没有 “Accept=application/json” 参 数 

(如 “text/html" 其 他 参数 ) ， 将 返回 "HTTP Status 406” 状 态 码 【 不 可 接受 ， 服 务 器 无 法 根据 
Accept 头 的 媒体 类 型 为 客户 端 生成 响应 】， 即 客户 只 接受 “application/json” 媒 体 类 型 的 数据 ， 
即 我 们 的 功能 处 理 方法 的 响应 只 能 返回 "application/json" 媒 体 类 型 的 数据 。 


@RequestMapping(value="/header/test5", headers = "Accept=text/*") : 表示 请 求 的 URL 必 
须 为 “/header/test5” 且 请 求 关中 必须 有 如 “Accept=text/plain”" 参 数 即 可 匹配 。 (将 Modify 
Header 的 Accept 参 数值 改 为 *text/plain? 即 可 ) ; 


Accept=text/* : 表示 主 类 型 为 text， 子 类 型 任意 ， 如 *text/plain” “text/html" 等 都 可 以 匹配 。 


@RequestMapping(value="/header/test6", headers = "Accept=/") : 表示 请 求 的 URL 必 须 
为 “/header/test6” 且 请 求 头 中 必须 有 任意 Accept 参 数 即 可 匹配 。 (将 Modify Header 的 Accept 
参数 值 改 为 "text/html" 或 “application/xml” 等 都 可 以 ) 。 


Accept=/ : 表示 主 类 型 任意 ， 子 类 型 任意 ， 如 “text/plain” “application/xml" 等 都 可 以 匹配 。 


6.5.4.5、 请 求 头 数据 中 指定 参数 名 != 值 


@RequestMapping(value="/header/test7", headers = "Accept!=text/vnd.wap.wml") : 表示 请 
求 的 URL 必 须 为 “</header/test7” 且 请 求 头 中 必须 有 “Accept 参 数 但 值 不 等 

于 "textvnd.wap.wmlP 即 可 匹配 。 

6.5.4.6、 组 合 使 用 是 “ 且 ” 的 关系 


@RequestMapping(value="/header/test8", headers = 
{"Accept!=text/vnd.wap.wml","abc=123")) : 表示 请 求 的 URL 必 须 为 “/header/test8” 且 请 求 头 
中 必须 有 “Accept" 参 数 但 值 不 等 于 "text/vnd.wap.wml" 且 请 求 中 必须 有 参数 “abc=123? 即 可 匹 
配 。 

注 : Accept:text/html,application/xhtml+xml,application/xml;q=0.9,/q=0.8 

如 果 您 的 请 求 中 含有 Accept : “A， 则 可 以 匹配 功能 处 理 方法 上 的 


如 *text/html” “text ， “application/xml” 等 。 
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Spring MVC 3.1 新 特性 生产 者 、 消 费 者 请 求 限定 
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SpringMVC 

6.6.5、 生 产 者 、 消 费 者 限定 

6.6.5.1、 基 本 概念 

首先 让 我 们 看 一 下 通过 HTTP 协 议 传 输 的 媒体 类 型 及 如 何 表示 媒体 类 型 : 

一 、Media Type : 


互联 网 媒体 类 型 ， 一 般 就 是 我 们 所 说 的 MIME 类 型 ， 用 来 确定 请 求 的 内 容 类 型 或 响应 的 内 容 类 


型 。 


写 道 媒体 类 型 格式 : type/subtype(;parameter)? type 主 类 型 ， 任 意 的 字符 串 ， 如 text， 如 果 是 
号 代表 所 有 ; subtype 子 类 型 ， 任 意 的 字符 串 ， 如 htm/， 如 果 是 号 代表 所 有 ; parameter 可 
选 ， 一 些 参 数 ， 如 Accept 请 求 头 的 q 参 数 ，Content-Type 的 charset 参 数 。 


详 见 http://tools.ietf.org/html/rfc2616#section-3.7 

常见 媒体 类 型 : 

text/html : HTML 格 式 text/plain : 纯 文本 格式 text/xml : XML 格式 
image/gif : gif 图 片 格式 image/jpeg : jpg 图 片 格式 image/png : png 图 片 格式 


application/x-www-form-urlencoded : <form encType=”> 中 默认 的 encType，form 表 单数 据 
被 编码 为 key/value 格 式 发 送 到 服务 器 (表单 默认 的 提交 数据 的 格式 ) 。 


multipart/form-data : 当 你 需要 在 表单 中 进行 文件 上 传 时 ， 就 需要 使 用 该 格式 ; 
application/xhtml+xml : XHTML 格式 application/xml : XML 数据 格式 
application/atom+xml : Atom XML 有 聚合 格式 application/json : JSON 数 据 格式 
application/pdf : pdf 格式 application/msword : Word 文 档 格式 
application/octet-stream : 二 进 制 流 数据 (如 常见 的 文件 下 载 ) 。 


在 如 tomcat 服 务 器 的 “conffweb.xml" 中 指定 了 扩展 名 到 媒体 类 型 的 映射 ， 在 此 我 们 可 以 看 到 服 
务 器 支持 的 媒体 类 型 。 


二 、Content-Type : 内 容 类 型 ， 即 请 求 /响应 的 内 容 区 数据 的 媒体 类 型 ; 


2.1、 请 求 头 的 内 容 类 型 ， 表 示 发 送 到 服务 器 的 内 容 数 据 的 媒体 类 型 ; 


request 中 设置 请 求 头 “Content-Type: application/x-www-form-urlencoded” 表 示 请 求 的 数据 为 
key/value 数 据 ; 


(1、 控 制 器 
cn.javass.chapter6.web.controller.consumesproduces.contenttype.RequestContentTy 
peController 


@RequestMapping(value = "/ContentType", method = RequestMethod ,GET ) 
public String showForm() throws IOException { 
//form 表 单 ， 使 用 application/x-www-form-urlencoded 编 码 方式 提交 表单 
return "consumesproduces/Content-Type"; 


} 
@RequestMapping(value = "/ContentType", method = RequestMethod.POST, 
headers = "Content-Type=application/x-www-form-urlencoded") 


public String request1i(HttpServletRequest request) throws IOEXxception { 
/VD 得 到 请 求 的 内 容 区 数据 的 类 型 
String contentType = request.getCcontentType(); 
System.out.println("========ContentType:" + contentType); 
//@@ 得 到 请 求 的 内 容 区 数据 的 编码 方式 ， 如 果 请 求 中 没有 指定 则 为 null 
// 注 意 ,， 我们 的 CharacterEncodingFilter 这 个 过 滤器 设置 了 编码 (UTF-8) 
// 编 码 只 能 被 指定 一 次 ， 即 如 果 客 户 端 设 置 了 编码 ， 则 过 滤器 不 会 再 设置 
String characterEncoding = request.getCharacterEncoding(); 
System.out.println("========CharacterEncoding:" + characterEncoding); 


//( 引 表示 请 求 的 内 容 区 数据 为 fForm 表 单 提交 的 参数 ， 此 时 我 们 可 以 通过 request .getParameter 得 到 数据 ( 
System.out.println(request.getParameter("realname")); 
System.out.println(request.getParameter ("username")); 

return "success"; 
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showForm 功 能 处 理 方式 : 展示 表单 ， 且 form 的 enctype="application/x-www-form- 
urlencoded"， 在 提交 时 请 求 的 内 容 类 型 头 为 “Content-Type:application/x-www-form- 
urlencoded” ; 


request1 功 能 处 理 方法 : 只 对 请 求 头 为 ‘Content-Type:application/x-www-form-urlencoded” 的 
请 求 进行 处 理 ( 即 消费 请 求 内 容 区 数据 ) ; 

request.getContentType() : 可 以 得 到 请 求 头 的 内 容 区 数据 类 型 ( 即 Content-Type 头 的 值 ) 
request.getCharacterEncoding() : 如 “Content-Type:application/json;charset=GBK"”, 则 得 到 的 


编码 为 “GBK”， 否 则 如 果 你 设置 过 滤器 (CharacterEncodingFilter) 则 得 到 它 设置 的 编码 ， 否 
则 返回 null。 


request.getParameter() : 因为 请 求 的 内 容 区 数据 为 application/x-www-form-urlencoded 格 式 
的 数据 ， 因 此 我 们 可 以 通过 request.getParameter() 得 到 相应 参数 数据 。 


request 中 设置 请 求 头 “Content-Type:application/json;charset=GBK” 表 示 请 求 的 内 容 区 数据 为 
json 类 型 数据 ， 且 内 容 区 的 数据 以 GBK 进 行 编码 ; 


(1、 控 制 器 
cn.javass.chapter6.web.controller.consumesproduces.contenttype.RequestContentTy 
peController 


@RequestMapping(value = "/request/ContentType", method = RedquestMethod ,POST， 
headers = "Content-Type=application/json") 
public String request2(HttpServletRequest request) throws IOException { 
// 四 表示 请 求 的 内 容 区 数据 为 j]Son 数 据 
InputStream is = request.getInputStream(); 
byte bytes[] = new byte[request.getCcontentLength()]; 
is.read(bytes); 
//@ 得 到 请 求 中 的 内 容 区 数据 (以 CharacterEncoding 解 码 ) 
// 此 处 得 到 数据 后 你 可 以 通过 如 json-1ib 转 换 为 其 他 对 象 
String jsonStr = new String(bytes, request.getcharacterEncoding()); 
System.out.println("json data:" + jsonstr); 
return "success"; 


request2 功 能 处 理 方法 : 只 对 请 求 头 为 “Content-Type:application/json” 的 进行 请 求 处 理 ( 即 消 
费 请 求 内 容 区 数据 ) ; 


request.getContentLength() : 可 以 得 到 请 求 头 的 内 容 区 数据 的 长 度 ; 


request.getCharacterEncoding() : 如 “Content-Type:application/json;charset=GBK"”, 则 得 到 的 
编码 为 ‘GBK”， 否 则 如 果 你 设置 过 滤器 (CharacterEncodingFilter) 则 得 到 它 设置 的 编码 ， 否 
则 返回 null。 


我 们 得 到 json 的 字符 串 形式 后 就 能 很 简单 的 转换 为 JSON 相 关 的 对 象 。 
(2、 客 户 端 发 送 json 数 据 请 求 


// 请 求 的 地 址 
String url = "http://localhost:9080/springmvc-chapter6/request/ContentType"; 
//G 创 建 Http Request( 内 部 使 用 HttpURLConnection) 
ClientHttpRequest request = 

new SimpleClientHttpRequestFactory(). 

createRequest(new URI(ur1l), HttpMethod.POST); 

//G@) 设 置 请 求 头 的 内 容 类 型 头 和 内 容 编码 (GBK) 
request.getHeaders().set("Content-Type", "application/json;charset=gbk"); 
//G) 以 GBK 编 码 写 出 请 求 内 容 体 
String jsonData = "{\"username\":\"zhang\", \"password\":\"123\"}"; 
request.getBody().write(jsonData.getBytes("gbk")); 
// 虽 发 送 请 求 并 得 到 响应 
ClientHttpResponse response = request.execute(); 
System.out.println(response.getSstatusCode()); 


此 处 我 们 使 用 Spring 提供 的 Http 客 户 端 API SimpleClientHttpRequestFactory 创 建 了 请 求 并 设 
置 了 请 求 的 Content-Type 和 编码 并 在 响应 体 中 号 回 了 json 数 据 ( 即 生产 json 类 型 的 数据 ) ， 此 
处 是 硬 编码 ， 实 际 工 作 可 以 使 用 json-lib 等 工具 进行 转换 。 


具体 代码 在 
cn.javass.chapter6.web.controller.consumesproduces.contenttype.RequestContentTypeClie 
nto 


堪 


2.2、 响应 头 的 内 容 类 
是 方向 相反 。 


， 表 示 发送 到 客户 端的 内 容 数据 类 型 ， 和 请 求 头 的 内 容 类 型 类似 ， 只 


@RequestMapping("/response/ContentType") 

public void response1i(HttpServletResponse response) throws IOException { 
/VD 表示 响应 的 内 容 区 数据 的 媒体 类 型 为 htm1 格 式 ， 且 编码 为 Utf-8( 客 户 端 应 该 以 Utf-8 解 码 ) 
response.setContentType("text/html;charset=utf-8"); 
//G@G) 写 出 响应 体内 容 
response.getWwriter().write("<font style='color:red'>hello</font>"); 


<!--[endif]--> 


如 上 所 示 ， 通 过 response.setContentType("text/html;charset=utf-8") 告诉 客户 端 响应 体 媒体 
类 型 为 html， 编 码 为 utf-8， 大 家 可 以 通过 chrome 工 具 查 看 响应 头 为 “Content- 
Type:text/html;charset=utf-8”， 还 一 个 “Content-Length:36” 表 示 响 应 体 大 小 。 


代码 在 
cn.javass.chapter6.web.controller consumesproduces.contenttype.ResponseContentTypeCo 
ntroller 。 


如 上 代码 可 以 看 出 Content-Type 可 以 指定 请 求 /响应 的 内 容 体 的 媒体 格式 和 可 选 的 编码 方式 。 
如 图 6-9 


| 服 
a 务 


i Content-Type: 媒 体 类 型 ; 编码 
端 
@ 客 户 端 一 发 送 请 求 一 服务 器 : 客户 端 通过 请 求 头 Content-Type 指 定 内 容 体 的 媒体 类 型 ( 即 客 


户 端 此 时 是 生产 者 ) ， 服 务 器 < 费 内 容 体 数据 ( 即 服 务 器 此 时 是 消费 
者 ) ; 


@ 服 务 器 一 发 送 请 求 一 客户 端 : 服务 器 生产 响应 头 Content-Type 指 定 的 响应 体 数 据 ( 即 服务 器 
此 时 是 生产 者 ) ， 客 户 端 根据 Content-Type 消 费 内 容 体 数据 ( 即 客户 端 此 时 是 消费 者 ) 。 


问题 : 
四 服务 器 端 可 以 通过 指定 【headers = "Content-Type=application/json"】 来 声明 可 处 理 (可 消 


费 ) 的 媒体 类 型 ， 只 消费 Content-Type 指 定 的 请 求 内 容 体 数据 ; 


@ 客 户 端 如 何 告诉 服务 re 费 什么 类 型 的 数据 呢 ? 即 客户 端 接受 (需要 ) Wa 型 
的 数据 呢 ? 服务器 应 该 生产 什么 类 型 0 求 的 Accept 请 求 头 来 实现 这 个 
功能 。 


三 、Accept : 用 来 指定 什么 媒体 类 型 的 响应 是 可 接受 的 ， 即 告诉 服务 器 我 需要 什么 媒体 类 型 
的 数据 ， 此 时 服务 器 应 该 根据 Accept 请 求 头 生产 指定 媒体 类 型 的 数据 。 


2.1、json 数 据 


@RequestMapping(value = "/response/ContentType", headers = "Accept=application/json") 
public void response2(HttpServletResponse response) throws IOException { 
/VD 表示 响应 的 内 容 区 数据 的 媒体 类 型 为 json 格 式 ， 且 编码 为 Utf-8( 客 户 端 应 该 以 Utf-8 解 码 ) 
response.setContentType("application/json;charset=utf-8"); 
// 回 号 出 响应 体内 容 
String jsonData = "{\"username\":\"zhang\", \"password\":\"123\"}"; 
response.getwriter().write(jsonData); 


} 
| 
服务 器 根据 请 求 头 “Accept=applicatiomjson" 生 产 json 数 据 。 

(2、 客 户 端 端 接收 服务 器 端 json 数 据 响 应 
使 用 浏览 器 测试 (Ajax 场景 使 用 该 方式 ) 


请 求 地 址 为 : http:Wlocalhost:9080/springmvc-chapter6/response/ContentType， 且 把 修改 请 
求 关 Accept 改 为 “Accept=application/json”: 


SE » 


第 二 下， 修 汉 请 求 网 aceept 藉 ] 


4 Accept application/json 舌 
Add Header 


Whitelisted domain *//* 


第 一 傅 ; od oti ication/ijson 


了 Response Headers 
Content~-Lenezth: 34 
Content— Type-: % P = 下 -~ 
Date: Wed, 28 Mar 2012 8680102135 GMT 
Server: Apache-Coyote/1.1 


第 三 步 。 内 容 区 的 数据 为 jsen 数 据 


Headers Preview | Reaponse | Cookies Timing 
1 {Username’;'zhang', password:'123°"} 





大 家 可 以 下 载 chrome 的 JSONView 插 件 来 以 更 好 看 的 方式 查看 json 数 据 ， 安 装 地 
址 : https://chrome.google.com/webstore/detail/chklaanhfefbnpoihckbnefhakgolnmc 








使 用 普通 客户 端 测 试 (服务 器 之 间 通 信 可 使 用 该 方式 ) 


private static void jsonRequest() throws IOException, URISyntaxException { 
// 请 求 的 地 址 
String url = "http://localhost:9080/springmvc-chapter6/response/ContentType"; 
//( 由 创建 Http Request( 内 部 使 用 HttpURLConnection) 
ClientHttpRequest request = 
new SimpleClientHttpRequestFactory(). 
createRequest(new URI(url), HttpMethod.POST); 
// 加 设置 客户 端 可 接受 的 媒体 类 型 ( 即 需要 什么 类 型 的 响应 体 数据 ) 
request.getHeaders().set("Accept", "application/json"); 
//( 引 发 送 请 求 并 得 到 响应 
ClientHttpResponse response = request.execute(); 
// 人 由 得 到 响应 体 的 编码 方式 
Charset charset = response.getHeaders().getContentType() .getCharSet() 
//G@ 得 到 响应 体 的 内 容 
InputStream is = response.getBody(); 
byte bytes[] = new byte[(int)response.getHeaders().getCcontentLength()]; 
is.read(bytes); 
String jsonData = new String(bytes, charset); 
System.out.println("charset : " + charset + ", json data : " + jsonData); 


request.getHeaders().set("Accept", "application/json") : 表示 客户 端 只 接受 ( 即 只 消费 ) json 
格式 的 响应 数据 ; 


response.getHeaders() : 可 以 得 到 响应 头 ， 从 而 可 以 得 到 响应 体 的 内 容 类 型 和 编码 、 内 容 长 
度 。 


2.2、Xml 数 据 


@RequestMapping(value = "/response/ContentType", headers = "Accept=application/xml") 
public void response3(HttpServletResponse response) throws IOException { 
/VD 表示 响应 的 内 容 区 数据 的 媒体 类 型 为 Xml 格式 ， 且 编码 为 Utf-8( 客 户 端 应 该 以 utf-8 解 码 ) 
response.setContentType("application/xml;charset=utf-8"); 
//G@G) 写 出 响应 体内 容 
String xmlData = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>",; 
xmlData += "<user><username>zhang</username><password>123</password></user>"; 
response.getwriter().write(xmlData); 


了 

和 生产 json 数 据 唯一 不 同 的 两 点 : 请 求 头 为 “Accept=application/xml"， 响 应 体 数据 为 Xml 。 
(2、 客 户 端 端 接收 服务 器 端 Xml 数 据 响 应 

使 用 浏览 器 测试 (Ajax 场景 使 用 该 方式 ) 


请 求 地 址 为 : http://localhost:9080/springmvc-chapter6/response/ContentType， 且 把 修改 请 
求 头 Accept 改 为 “Accept=application/xml”, 和 json 方 式 类 似 ， 此 处 不 再 重复 。 


使 用 普通 客户 端 测 试 (服务 器 之 间 通 信 可 使 用 该 方式 ) 


private static void xmlRequest() throws IOException, URISyntaxException { 
// 请 求 的 地 址 
String url = "http://localhost:9080/springmvc-chapter6/response/ContentType"; 
//G 创 建 Http Request( 内 部 使 用 HttpURLConnection) 
ClientHttpRequest request = 
new SimpleClientHttpRequestFactory(). 
createRequest(new URI(url1), HttpMethod.POST); 
// 加 设置 客户 端 可 接受 的 媒体 类 型 ( 即 需要 什么 类 型 的 响应 体 数据 ) 
request.getHeaders().set("Accept", "application/xml"); 
//(3) 发 送 请 求 并 得 到 响应 
ClientHttpResponse response = request.execute(); 
//( 旬 得 到 响应 体 的 编码 方式 
Charset charset = response.getHeaders().getCcontentType().getcharSset(); 
// 回 得 到 响应 体 的 内 容 
InputStream is = response.getBody(); 
byte bytes[] = new byte[(int)response.getHeaders().getcontentLength()]; 
is.read(bytes); 
String xmlData = new String(bytes, charset); 
System.out.println("charset : "+ charset + ", xml data : " + xmlData); 


request.getHeaders().set("Accept", "application/xml") : 表示 客户 端 只 接受 ( 即 只 消费 ) xml 格 
式 的 响应 数据 ; 


response.getHeaders() : 可 以 得 到 响应 头 ， 从 而 可 以 得 到 响应 体 的 内 容 类 型 和 编码 、 内 容 长 
度 。 


ee RS Aa 
头 告 诉 它们 我 们 需要 什么 类 型 的 数据 ， 他 们 根据 我 们 的 Accept 来 判断 需要 返回 什么 类 型 的 数 
据 。 


实际 项 目 使 用 Accept 请 求 头 是 比较 麻烦 的 ， 现 在 大 多 数 开放 平台 (国内 的 新 浪 微 博 、 淘 宝 、 
腾讯 等 开放 平台 ) 使 用 如 下 两 种 方式 : 


扩展 名 : 如 response/ContentType.json response/ContentType.xml 方 式 ， 使 用 扩展 名 表示 需 
要 什么 类 型 的 数据 ; 


参数 : 如 response/ContentType?format=json response/ContentType?format=xml， 使 用 参数 
表示 需要 什么 类 型 的 数据 ; 

也 就 是 说 ， 目 前 我 们 可 以 使 用 如 上 三 种 方式 实现 来 告诉 服务 器 我 们 需要 什么 类 型 的 数据 ， 但 
麻烦 的 是 现在 有 三 种 实现 方式 ， 难 道 我 们 为 了 支持 三 种 类 型 的 数据 就 要 分 别 进行 三 种 实现 


吗 ? 当然 不 要 这 么 麻烦 ， 后 续 我 们 会 学 ContentNegotiatingViewResolver， 它 能 帮助 我 们 做 到 
这 一 点 。 


6.6.5.2、 生 产 者 消费 者 流程 图 
生产 者 消费 者 流程 ， 如 图 6-10 : 
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从 图 6-10 可 以 看 出 : 


请 求 阶段 : 客户 端 是 生产 者 【生产 Content-Type 媒 体 类 型 的 请 求 内 容 区 数据 】， 服 务 器 是 消 
费 者 【消费 客户 端 生产 的 Content-Type 媒 体 类 型 的 请 求 内 容 区 数据 】 ; 


响应 阶段 : 服务 器 是 生产 者 【生产 客户 端 请 求 头 参数 Accept 指 定 的 响应 体 数 据 】， 客 户 端 是 
消费 者 【消费 服务 器 根据 Accept 请 求 头 生产 的 响应 体 数据 】 


如 上 生产 者 /消费 者 写法 无 法 很 好 的 体现 我 们 分 析 的 生产 者 /消费 者 模式 ，Spring3.1 为 生产 者 / 
消费 者 模式 提供 了 简化 支持 ， 接 下 来 我 们 学 习 一 下 如 何在 Spring3.1 中 来 实现 生产 者 /消费 者 模 
式 吧 。 


6.6.5.3、 生 产 者 、 消 费 者 限定 


Spring3.1 开 始 支持 消费 者 、 生 产 者 限定 ， 而 且 必 须 使 用 如 下 HandlerMapping 和 
HandlerAdapter 才 支持 : 


<!--Spring3.1 开 始 的 注解 HandlerMapping --> 

<bean 
class='"org.springframework.web.servlet.mvc.method.annotation.RedquestMappingHandJlerMapping 
<!--Spring3.1 开 始 的 注解 HandlerAdapter --> 

<bean 
class='"org.springframework.web.servlet.mvc.method.annotation.RedquestMappingHandJlerAdapter 


图 ”| 
一 、 功 能 处 理 方法 是 消费 者 





@RequestMapping(value = "/consumes", consumes = et ol : 此 处 使 用 
consumes 来 指定 功能 处 理 方 法 能 消费 的 媒体 类 型 ， 其 通过 请 求 头 的 "Content-Type" 来 判断 。 


此 种 方式 相对 使 用 @RequestMapping 的 “headers = "Content-Type=application/json" 更 能 表 
明 你 的 目的 。 


服务 器 控制 器 代码 详解 
cn.javass.chapter6.web.controllerconsumesproduces.ConsumesController ; 


客户 端 代 码 类 似 于 之 前 的 Content-Type 中 的 客户 端详 见 ConsumesClient.。 


二 、 功 能 处 理 方法 是 生产 者 


@RequestMapping(value = "/produces", produces = "application/json") : 表示 将 功能 处 理 方 
法 将 生产 json 格 式 的 数据 ， 此 时 根据 请 求 头 中 的 Accept 进 行 匹 配 ， 如 请 求 
头 “Accept:application/json” 时 即 可 匹配 ; 


@RequestMapping(value = "/produces", produces = "application/xml") : 表示 将 功能 处 理 方 
法 将 生产 xml 格 式 的 数据 ， 此 时 根据 请 求 头 中 的 Accept 进 行 匹配 ， 如 请 求 
头 “Accept:application/xml" 时 即 可 匹配 。 


此 种 方式 相对 使 用 @RequestMapping 的 “headers = "Accept=application/json" 更 能 表明 你 的 
目的 。 


服务 器 控制 器 代码 详解 
cn.javass.chapter6.web.controller consumesproduces.ProducesController ; 


客户 端 代码 类 似 于 之 前 的 Content-Type 中 的 客户 端详 见 ProducesController.。 

当 你 有 如 下 Accept 头 : 

中 Accept : text/html,application/xml,application/json 

将 按照 如 下 顺序 进行 produces 的 匹配 @text/html @application/xml @application/json 
OAccept : application/xml;q=0.5,application/json;q=0.9,text/html 

将 按照 如 下 顺序 进行 produces 的 匹配 @text/html @application/json @application/xml 
q 参 数 为 媒体 类 型 的 质量 因子 ， 越 大 则 优先 权 越 高 (从 0 到 1) 

@Accept : jptext/*,text/html 

将 按照 如 下 顺序 进行 produces 的 匹配 @text/html @text/ @/* 

即 匹配 规则 为 : 最 明确 的 优先 匹配 。 


代码 详 见 ProducesPrecedenceController1、ProducesPrecedenceController2、 
ProducesPrecedenceController3。 


Accept 详 细 信息 ， 请 参考 http://tools.ietf.org/html/rfc2616#section-14.1。 
三 、 窒 化 时 是 履 盖 而 非 继承 


如 类 级 别 的 映射 为 @RequestMapping(value="/narrow", produces="text/html")， 方 法 级 别 的 
为 @RequestMapping(produces="application/xml")， 此 时 方法 级 别 的 映射 将 覆盖 类 级 别 的 ， 
因此 请 求 头 “Accept:application/xml" 有 是 成 功 的 ， 而 "text/html" 将 报 406 错 误 码 ， 表 示 不 支持 的 请 


求 媒体 类 型 。 


详 见 cn.javass.chapter6.web.controller.consumesproduces.NarrowController 。 


只 有 生产 者 /消费 者 模式 是 覆盖， 其 他 的 使 用 方法 是 继承 ， 如 headers、params 等 都 是 继 
承 。 


四 、 组 合 使 用 是 “或 ”的 关系 


@RequestMapping(produces={"text/html", "application/json")) : 将 匹 
配 “Accept:text/html" 或 “Accept:applicatiom/json”。 


五 、 问 题 


消费 的 数据 ， 如 JSON 数 据 、XML 数 据 都 是 由 我 们 读 取 请 求 的 InputStream 并 根据 需要 自己 转 
换 为 相应 的 模型 数据 ， 上 比较 麻烦 ; 


生产 的 数据 ， 如 JSON 数 据 、XML 数 据 都 是 由 我 们 自己 先 把 模型 数据 转换 为 json/xml 等 数据 ， 
然后 输出 响应 流 ， 也 是 比较 麻烦 的 。 


Spring 提 供 了 一 组 注解 ( @RequestBody 、 @ResponseBody ) 和 一 组 转换 类 
( HttpMessageConverter ) 来 完成 我 们 遇 到 的 问题 ， 详 见 6.6.8 节 。 


SpringMVC 强 大 的 数据 绑 定 (1) 一 一 第 六 章 注解 
式 控 制 器 详解 一 一 跟着 开 涛 学 SpringMVC 


到 目前 为 止 ， 请 求 已 经 能 交 给 我 们 的 处 理 器 进行 处 理 了 ， 接 下 来 的 事情 是 要 进行 收集 数据 
啦 ， 接 下 来 我 们 看 看 我 们 能 从 请 求 中 收集 到 哪些 数据 ， 如 图 6-11 : 
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图 6-11 

1、@RequestParam 绑 定单 个 请 求 参 数值 ; 
2、@PathVariable 绑 定 URI 模 板 变 量 值 ; 
3、@CookieValue 绑 定 Cookie 数 据 值 
4、@RedquestHeader 绑 定 请 求 头 数据 ; 
5、@ModelValue 绑 定 参 数 到 命令 对 象 ; 


6、@SessionAttributes 绑 定 命令 对 象 到 Session ; 


加 靖 束 URL 国 协 设 及 裔 本 请 求 信息 





eaRequestParam 疆 定 单个 请 求 念 数 
epathVyariable 绑 定 URI 模 板 变量 
8CookieYalue 姓 定 Cookie 数 据 
QRequesttleader 绑 定 清 求 头 数据 


euodelAtrtribute 关 定 参数 到 命令 对 象 
BSessionAttributes 绑 定 命令 对 象 到 session 
eRequestBody 绑 定 请 求 内 容 区 数据 

8@RequestPart 绑 定 “multipart/form-data” 数 据 
eValue SpEL 表 达 式 

自 定 义 参 数 注 解 


7、@RequestBody 绑 定 请 求 的 内 容 区 数据 并 能 进行 自动 类 型 转换 等 。 


8、 nim ， 除 了 能 绑 定 @RequestParam 能 做 到 的 请 求 参 数 


外 ， 还 能 绑 定 上 传 的 文件 等 


除了 上 边 提 到 的 注解 ， 我 们 还 可 以 通过 如 HttpServletRequest 等 API 得 到 请 求 数据 ， 但 推荐 使 


用 注解 方式 ， 因 为 使 用 起 来 更 简单 。 
接 下 来 先 看 一 下 功能 处 理 方法 支持 的 参数 类 型 吧 。 


6.6.1、 功 能 处 理 方 法 支持 的 参数 类 型 


在 继续 学 习 之 前 ， 我 们 需要 首先 看 看 功能 处 理 方法 支持 哪些 类 型 的 形式 参数 ， 以 及 他 们 的 有 具 
体 含 义 。 


一 、ServletRequest/HttpServletRequest 和 ServletResponse/HttpServletResponse 


public String requestOrResponse ( 
ServletRequest servletRequest, HttpServletRequest httpServletRequest, 
ServletResponse servletResponse, HttpServletResponse httpServletResponse 


Spring Web MVC 框 架 会 自动 帮助 我 们 把 相应 的 Servlet 请 求 /响应 (Servlet API) 作为 参数 传 
递 过 来 。 


二 、InputStream/OutputStream 和 ReaderWriter 


public void inputoroutBody(InputStream requestBodyIn, OutputStream responseBodyoOut ) 
throws IOException { 
responseBodyOut .write("success".getBytes()); 


} 


i 


requestBodyln : 获取 请 求 的 内 容 区 字 节 流 ， 等 价 于 request.getlnputStream(); 


i 


responseBodyOut : 获取 相应 的 内 容 区 字 节 流 ， 等 价 于 response.getOutputStream()。 


public void readerorwriteBody(Reader reader, Writer writer) 
throws IOException { 
writer .write("hello"); 


reader : 获取 请 求 的 内 容 区 字符 流 ， 等 价 于 request.getReader(); 

writer : 获取 相应 的 内 容 区 字符 流 ， 等 价 于 response.getWriter()。 
InputStream/OutputStream 和 Reader/Writer 两 组 不 能 同时 使 用 ， 只 能 使 用 其 中 的 一 组 。 
三 、WebRequest/NativeWebRequest 


WebRequest 是 Spring Web MVC 提 供 的 统一 请 求 访问 接口 ， 不 仅仅 可 以 访问 请 求 相关 数据 
(如 参数 区 数据 、 请 求 头 数据 ， 但 访问 不 到 Cookie 区 数据 ) ， 还 可 以 访问 会 话 和 上 下 文中 的 
数据 ; NativeWebRequest 继 承 了 WebRequest， 并 提供 访问 本 地 Servlet API 的 方法 。 


public String webRequest(WebRequest webRequest, NativeWebRequest nativewebRequest) { 

System.out.println(webRequest.getParameter("test"));//QD 得 到 请 求 参数 test 的 值 
webRequest.setAttribute("name", "value", WebRequest.SCOPE_ REQUEST);//® 
System.out.println(webRequest.getAttribute("name", WebRequest.SCOPE_ REQUEST)); 
HttpServletRequest request = 

nativewebRequest .getNativeRequest(HttpServletRequest.class);//®) 
HttpServletResponse response = 

nativewebRequest.getNativeResponse(HttpServletResponse.class); 

return "success"; 


@ webRequest.getParameter : 访问 请 求 参 数 区 的 数据 ， 可 以 通过 getHeader() 访 问 请 求 头 数 
据 ; 


@ webRequest.setAttribute/getAttribute : 到 指定 的 作用 范围 内 取 / 放 属性 数据 ，Servlet 定 义 的 
三 个 作用 范围 分 别 使 用 如 下 常量 代表 : 


: 代表 请 求 作用 范围 ; 
: 代表 会 话 作用 范围 ; 
: 代表 全 局 会 话 作 用 范围 ， 即 ServletContext 上 下 文 作 用 范围 。 


@ nativeWebRequest.getNativeRequest/nativeWebRequest.getNativeResponse : 得 到 本 地 
的 Servlet API。 


四 、HttpSession 


public String session(HttpSession session) { 
System.out.println(session); 
return "success"; 


此 处 的 session 永 远 不 为 null。 


注意 : Session 访 问 不 是 线程 安全 的 ， 如 果 需 要 线程 安全 ， 需 要 设置 
AnnotationMethodHandlerAdapter 或 RequestMappingHandlerAdapter 的 
synchronizeOnSession 属 性 为 true， 即 可 线程 安全 的 访问 session 。 


、 命 令 / 表 单 对 象 


Spring Web MVC 能 够 自动 将 请 求 参 数 绑 定 到 功能 处 理 方法 的 命令 /表单 对 象 上 。 


@RequestMapping(value = "/commandobject"，method = RequestMethod ,GET) 
public String toCreateUser(HttpServletRequest request, UserModel user) { 
return "customer/create"; 


@RequestMapping(value = "/commandObject", method = RequestMethod.POST) 
public String createUser(HttpServletRequest request, UserModel user) { 


System.out.println(user); 
return "success"; 


如 果 提 交 的 表单 (包含 username 和 password 文 本 域 ) ， 将 自动 将 请 求 参 数 绑 定 到 命令 对 象 
user 中 去 。 


六 、Model、Map、ModelMap 


Spring Web MVC 提供 Model、Map 或 ModelMap 让 我 们 能 露 泻 染 视图 需要 的 模型 数据 。 


@RequestMapping(value = "/model") 
public String createUser(Model model, Map model2, ModelMap model3) { 
model.addAttribute("a", "a"); 
model2.put("b", "b"); 
model3.put("c", "c"); 
System.out.println(model == model12); 
System.out.println(model2 == model3); 
return "success";} 


虽然 此 处 注入 的 是 三 个 不 同 的 类 型 (Model model, Map model2, ModelMap model3) ， 但 三 
者 是 同一 个 对 象 ， 如 图 6-12 所 示 : 
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图 6-11 


AnnotationMethodHandlerAdapter 和 RequestMappingHandlerAdapter 将 使 用 
BindingAwareModelMap 作 为 模型 对 象 的 实现 ， 即 此 处 我 们 的 形 参 (Model model, Map 
model2, ModelMap model3) 都 是 同一 个 BindingAwareModelMap 实 例 。 


此 处 还 有 一 点 需要 我 们 注意 : 


@RequestMapping(value = "/mergeModel") 

public ModelAndView mergeModel(Model model) { 
model.addAttribute("a",，"a");//Q) 添 加 模型 数据 
ModelAndView mv = new ModelAndView("success"); 
mv.addobject("a",，"update");//@@ 在 视图 演 染 之 前 更 新 (3) 处 同名 模型 数据 
model.addAttribute("a"，"new");//(3) 修 改 (QD) 处 同名 模型 数据 
// 视 图 页 面 的 a 将 显示 为 "Update" 而 不 是 "new" 
return mv; 


从 代码 中 我 们 可 以 总 结 出 功能 处 理 方法 的 返回 值 中 的 模型 数据 (如 ModelAndView) 会 合并 
功能 处 理 方法 形式 参数 中 的 模型 数据 (如 Model) ， 但 如 果 两 者 之 间 有 同名 的 ， 返 回 值 中 的 模 
型 数据 会 覆盖 形式 参数 中 的 模型 数据 。 


七 、Errors/BindingResult 


@RequestMapping(value = "/error1") 
public String errori(UserModel user, BindingResult result) 


@RequestMapping(value = "/error2") 
public String error2(UserModel user, BindingResult result, Model model) { 


@RequestMapping(value = "/error3") 
public String error3(UserModel user, Errors errors) 


以 上 代码 都 能 获取 错误 对 象 。 
Spring3.1 之 前 (使 用 AnnotationMethodHandlerAdapter) 错误 对 象 必 须 紧 跟 在 命令 对 象 /表单 
对 象 之 后 ， 如 下 定义 是 错误 的 : 


@RequestMapping(value = "/error4") 
public String error4(UserModel user, Model model, Errors errors) 


} 
如 上 代码 从 Spring3.1 开 始 (使 用 RequestMappingHandlerAdapter) 将 能 正常 工作 ， 但 还 是 推 
荐 "错误 对 象 紧 跟 在 命令 对 象 /表单 对 象 之 后 ”， 这 样 是 万 无 一 失 的 。 
Errors 及 BindingResult 的 详细 使 用 请 参考 4.16.2 数 据 验证 。 


人 、 其 他 杂项 


public String other(Locale locale, Principal principal) 


java.util.Locale : 得 到 当前 请 求 的 本 地 化 信息 ， 默 认 等 价 于 ServletRequest.getLocale()， 如 果 
配置 LocaleResolver 解 析 器 则 由 它 决 定 Locale， 后 续 介 绍 ; 


java.security.Principal : 该 主体 对 象 包含 了 验证 通过 的 用 户 信 息 ， 等 价 于 
HttpServletRequest.getUserPrincipal()° 


以 上 测试 在 cn.javass.chapter6.web.controller.paramtype.MethodParamTypeController 中 。 


其 他 功能 处 理 方法 的 形 和 类 型 (如 HttpEntity、UriComponentsBuilder、SessionStatus 、 
RedirectAttributes ) 将 在 后 续 章节 详细 讲解 。 


第 二 部 分 会 介绍 注解 方式 的 数据 绑 定 。 


SpringMVC 强 大 的 数据 绑 定 (2) 一 一 第 六 章 注解 
式 控制 器 详解 一 跟着 开 涛 学 SpringMVC 


6.6.2、@RedquestParam 绑 定单 个 请 求 参 数值 
@RequestParam 用 于 将 请 求 参数 区 数据 映射 到 功能 处 理 方法 的 参数 上 。 


public String requestparami(@RequestParam String username) 


请 求 中 包含 username 参 数 (如 /requestparam1?username=zhang) ， 则 自动 传 入 。 


此 处 要 特别 注意 : 右 击 项 目 ， 选 择 “ 属 性 ”*"， 打 开 “ 属 性 对 话 框 *， 选择 “Java Compiler" 然 后 再 打 
开 的 选项 卡 将 “Add variable attributes to generated class files” 取 消 义 选 ， 意 思 是 不 将 局 部 变 
量 信息 添加 到 类 文件 中 ， 如 图 6-12 所 示 : 
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当 你 在 浏览 器 输入 URL， 如 “requestparam1?username=123” 时 会 报 如 下 错误 


Name for argument type [java.lang.String] not available, and parameter name information 
not found in class file either， 表 示 得 不 到 功能 处 理 方法 的 参数 名 ， 此 时 我 们 需要 如 下 方法 进 
行 入 参 : 


public String requestparam2(@RequestParam("username") String username) 


即 通过 @RequestParam("username") 明 确 告 诉 Spring Web MVC 使 用 username 进 行 入 参 。 


接 下 来 我 们 看 一 下 @RequestParam 注 解 主要 有 哪些 参数 : 





value : 参数 名 字 ， 即 入 参 的 请 求 参 数 名 字 ， 如 username 表 示 请 求 的 参数 区 中 的 名 字 为 
Username 的 参数 的 值 将 传 入 ; 


required : 是 否 必 须 ， 默 认 是 true， 表 示 请 求 中 一 定 要 有 相应 的 参数 ， 否 则 将 报 404 错 误 码 ; 


defaultValue : 默认 值 ， 表示 如 果 请 求 中 没有 同名 参数 时 的 默认 值 ， 默认 值 可 以 是 SpEL 表 达 
式 ， 如 做 {systemProperties[java.vm.version']}》”。 


public String requestparam4(@RequestParam(value="username",required=false) String usernam 


<| = 











表示 请 求 中 可 以 没有 名 字 为 Username 的 参数 ， 如 果 没 有 默认 为 null， 此 处 需要 注意 如 下 几 
汪 


原子 类 型 : 必须 有 值 ， 否 则 抛 出 异常 ， 如 果 人 允许 空 值 请 使 用 包装 类 代替 。 


Boolean 包 装 类 型 类 型 : 默认 Boolean.FALSE， 其 他 引用 类 型 默认 为 null。 


public String requestparam5( 
@RequestParam(value="username", required=true, defaultValue="zhang") String username) 


表示 如 果 请 求 中 没有 名 字 为 username 的 参数 ， 默 认 值 为 “zhang”。 


如 果 请 求 中 有 多 个 同名 的 应 该 如 何 接收 呢 ? 如 给 用 户 授 权时 ， 可 能 授予 多 个 权限 ， 首 先 看 下 
如 下 代码 : 


public String requestparam7(@RequestParam(value="role") String roleList) 


如 果 请 求 参数 类 似 于 url?role=admin&rule=user， 则 实际 roleList 参 数 入 参 的 数据 
为 “admin,user”， 即 多 个 数据 之 间 使 用 *，” 分 割 ; 我 们 应 该 使 用 如 下 方式 来 接收 多 个 请 求 参 
数 : 


public String requestparam7(@RequestParam(value="role") String[] roleList) 


或 


public String requestparam8(@RequestParam(value="list") List<String> list) 


到 此 @RequestParam 我 们 就 介绍 完了 ， 以 上 测试 代码 在 cn.javass.chapter6.web.controller. 


paramtype.RequestParamTypeController 中 。 


6.6.3、@PathVariable 绑 定 URI 模 板 变 量 值 


@PathVariable 用 于 将 请 求 URL 中 的 模板 变量 映射 到 功能 处 理 方法 的 参数 上 。 


@RequestMapping(value="/users/{userId}/topics/{topicId}") 
public String test( 
@Pathvariable(value="userId") int userId, 
@PathVvariable(value="topicId") int topicId) 


如 请 求 的 URL 为 “控制 器 URL/users/123/topics/456”， 则 自动 将 URL 中 模板 变量 {userld} 和 
{topicld} 绑 定 到 通过 @PathVariable 注 解 的 同名 参数 上 ， 即 入 参 后 userld=123、topicld=456。 
代码 在 PathVariableTypeController 中 。 

6.6.4、@CookieValue 绑 定 Cookie 数 据 值 


@CookieValue 用 于 将 请 求 的 Cookie 数 据 映 射 到 功能 处 理 方 法 的 参数 上 。 


public String test(@CookieValue(value="JSESSIONID", defaultValue="") String sessionId) 


如 上 配置 将 自动 将 JSESSIONID 值 入 和 参 到 sessionld 参 数 上 ，defaultValue 表 示 Cookie 中 没有 
JSESSIONID 时 默认 为 空 。 


public String test2(@CookieValue(value="JSESSIONID", defaultValue="") Cookie sessionId) 
[= = = 
传 入 参数 类 型 也 可 以 是 javax.servlet.http.Cookie 类 型 。 
测试 代码 在 CookieValueTypeController 中 。@CookieValue 也 拥有 和 @RequestParam 相 同 的 
三 个 参数 ， 含 义 一 样 。 
6.6.5、@RequestHeader 绑 定 请 求 头 数据 


@RequestHeader 用 于 将 请 求 的 头 信 息 区 数据 映射 到 功能 处 理 方法 的 参数 上 。 


@RequestMapping(value="/header") 

public String test( 
@RequestHeader ("User-Agent") String userAgent, 
@RequestHeader (value="Accept") String[] accepts) 


如 上 配置 将 自动 将 请 求 头 "User-Agent" 值 入 参 到 userAgent 参 数 上 ， 并 将 “Accept" 请 求 头 值 入 
参 到 accepts 参 数 上 。 测 试 代 码 在 HeaderValueTypeController 中 。 


@RequestHeader 也 拥有 和 @RequestParam 相 同 的 三 个 参数 ， 含 义 一 样 。 


6.6.6、@ModelAttribute 绑 定 请 求 参 数 到 命令 对 象 
@ModelAttribute 一 个 具有 如 下 三 个 作用 : 


@@ 绑 定 请 求 参数 到 命令 对 象 : 放 在 功能 处 理 方 法 的 入 参 上 时 ， 用 于 将 多 个 请 求 参 数 绑 定 到 一 个 
命令 对 象 ， 从 而 简化 绑 定 流程 ， 而 且 自 动 暴露 为 模型 数据 用 于 视图 页 面 展 示 时 使 用 ; 


加 暴露 表单 引用 对 象 为 模型 数据 : 放 在 处 理 器 的 一 般 方 法 ( 非 功 能 处 理 方法 ) 上 时 ， 是 为 表单 
准备 要 展示 的 表单 引用 对 象 ， 如 注册 时 需要 选择 的 所 在 城市 等 ， 而 且 在 执行 功能 处 理 方法 
(@RequestMapping 注 解 的 方法 ) 之 前 ， 自 动 添加 到 模型 对 象 中 ， 用 于 视图 页 面 展示 时 使 
用 ; 


加 暴露 @RequestMapping 方 法 返回 值 为 模型 数据 : 放 在 功能 处 理 方法 的 返回 值 上 时 ， 是 暴露 
功能 处 理 方 法 的 返回 值 为 模型 数据 ， 用 于 视图 页 面 展示 时 使 用 。 


一 、 绑 定 请 求 参数 到 命令 对 象 


如 用 户 登 录 ， 我 们 需要 捕获 用 户 登 录 的 请 求 参数 (用 户 名 、 密 码 ) 并 封装 为 用 户 对 象 ， 此 时 
我 们 可 以 使 用 @ModelAttribute 绑 定 多 个 请 求 参数 到 我 们 的 命令 对 象 。 


public String test1(@ModeJAttribute("user") UserModel user) 


和 6.6.1 一 节 中 的 五 、 命 令 / 表 单 对 象 功 能 一 样 。 只 是 此 处 多 了 一 个 注解 
@ModelAttribute("user")， 它 的 作用 是 将 该 绑 定 的 命令 对 象 以 "user 为 名 称 添 加 到 模型 对 象 中 
供 视 图 页 面 展示 使 用 。 我 们 此 时 可 以 在 视图 页 面 使 用 ${userusername} 来 获取 绑 定 的 命令 对 象 
的 属性 。 

绑 定 请 求 参 数 到 命令 对 象 支持 对 象 图 导航 式 的 绑 定 ， 如 请 求 参数 包含 "? 


username=zhang&password=123&worklnfo.city=bj 自 动 绑 定 到 user 中 的 worklnfo 属 性 的 city 
属性 中 。 


@RequestMapping(value="/model2/{username}") 
public String test2(@ModelAttribute("model") DataBinderTestModel model) { 


DataBinderTestModel 相 关 模 型 请 从 第 三 章 找 贝 过 来 ， 请 求 参 数 到 命令 对 象 的 绑 定 规则 详 见 
【4.16.1、 数 据 绑 定 】 一 节 ，URI 模 板 变量 也 能 自动 绑 定 到 命令 对 象 中 ， 当 你 请 求 的 URL 中 包 

含 “bool=yes&schoolnfo.specialty=computer&hobbyList[0]=program&hobbyList[1]=music&m 

ap[key1]=value1&map[key2]=value2&state=blocked "会 自动 绑 定 到 命令 对 象 上 。 


当 URI 模 板 变 量 和 请 求 参数 同名 时 ，URI 模 板 变量 具有 高 优先 权 。 


二 、 暴 器 表单 引用 对 象 为 模型 数据 


@ModelAttribute("cityList") 
public List<String> cityList() { 

return Arrays.asList(" 北 京 "，" 山 东 "); 
} 


如 上 代码 会 在 执行 功能 处 理 方法 之 前 执行 ， 并 将 其 自动 添加 到 模型 对 象 中 ， 在 功能 处 理 方法 
中 调用 Model 入 参 的 containsAttribute("cityList") 将 会 返回 true。 


@ModelAttribute("user") //GD 
public UserModel getUser(@RequestParam(value="username", defaultValue="") String username 
//TODO 去 数据 库 根据 用 户 名 查找 用 户 对 象 
UserModel user = new UserModel(); 
USer .SetRealname("zhang") ; 
return USser 


国 Ee 


如 你 要 修改 用 户 资料 时 一 般 需 要 根据 用 户 的 编号 /用 户 名 查找 用 户 来 进行 编辑 ， 此 时 可 以 通过 
如 上 代码 查找 要 编辑 的 用 户 。 








也 可 以 进行 一 些 默认 值 的 处 理 。 


@RequestMapping(value="/model1") //® 
public String test1i(@ModelAttribute("user") UserModel user, Model model) 


此 处 我 们 看 到 加 和 回 有 同名 的 命令 对 象 ， 那 Spring Web MVC 内 部 如 何 处 理 的 呢 : 


(1、 首 先 执行 @ModelAttribute 注 解 的 方法 ， 准 备 视图 展示 时 所 需要 的 模型 数据 ; 
@ModelAttribute 注 解 方法 形式 参数 规则 和 @RequestMapping 规 则 一 样 ， 如 可 以 有 
@ReduestParam 等 ; 

(2、 执 行 @RequestMapping 注 解 方法 ， 进 行 模型 绑 定 时 首先 查找 模型 数据 中 是 否 含有 同名 
对 象 ， 如 果 有 直接 使 用 ， 如 果 没 有 通过 反射 创建 一 个 ， 因 此 @ 处 的 user 将 使 用 @ 处 返回 的 命令 
对 象 。 即 回 处 的 User 等 于 加 处 的 User 。 


三 、 暴 露 @RequestMapping 方 法 返回 值 为 模型 数据 


public @ModelAttribute("user2") UserModel test3(@ModelAttribute("user2") UserModel user) 
二 | 
大 家 可 以 看 到 返回 值 类 型 是 命令 对 象 类 型 ， 而且 通过 @ModelAttribute("user2") 注 解 ， 此 时 会 
暴露 返回 值 到 模型 数据 (名 字 为 User2) 中 供 视图 展示 使 用 。 那 哪个 视图 应 该 展示 呢 ? 此 时 
Spring Web MVC 会 根据 RequestToViewNameTranslator 进 行 逻 辑 视 图 名 的 翻译 ， 详 见 
【4.15.5、RequestToViewNameTranslator】 一 节 。 


此 时 又 有 问题 了 ，@RequestMapping 注 解 方法 的 入 参 user 暴 露 到 模型 数据 中 的 名 字 也 是 
User2， 其 实 我 们 能 猜 到 : 


(3、@ModelAttribute 注 解 的 返回 值 会 覆盖 @RequestMapping 注 解 方法 中 的 
@ModelAttribute 注 解 的 同名 命令 对 象 。 
四 、 匿 名 乡 定 命令 参数 
public String test4(@ModelAttribute UserModel user, Model model) 


号 


public String test5(UserModel user, Model model) 


此 时 我 们 没有 为 命令 对 象 提供 暴露 到 模型 数据 中 的 名 字 ， 此 时 的 名 字 是 什么 呢 ? Spring Web 
MVC 自 动 将 简单 类 名 ( 首 字母 小 写 ) 作为 名 字 暴 露 ， 
如 “cn.javass.chapter6.model.UserModel" 骏 露 的 名 字 为 “UserModel”。 


public @ModelAttribute List<String> test6() 


public @ModelAttribute List<UserModel> test7() 


对 于 集合 类 型 (Collection 接 口 的 实现 者 们 ， 包 括 数组 ) ， 生 成 的 模型 对 象 属性 名 为 “简单 类 名 
( 首 字母 小 写 ) "+“List*， 如 List<String> 生 成 的 模型 对 象 属 性 名 为 “stringList”， 
List<UserModel> 生 成 的 模型 对 象 属性 名 为 “userModelList"。 


其 他 情况 一 律 都 是 使 用 简单 类 名 ( 首 字母 小 写 ) 作为 模型 对 象 属性 名 ， 如 Map<String， 
UserModel> 类 型 的 模型 对 象 属性 名 为 "map”。 


6.6.7、@SessionAttributes 绑 定 命令 对 象 到 session 


有 时 候 我 们 需要 在 多 次 请 求 之 间 保 持 数据 ， 一 般 情况 需要 我 们 明确 的 调用 HttpSession 的 API 
来 存 取 会 话 数据 ， 如 多 步骤 提交 的 表单 。Spring Web MVC 提 供 了 @SessionAttributes 进 行 请 
求 间 透 明 的 存 取 会 话 数 据 。 


/V/1、 在 控制 器 类 头 上 添加 @SessionAttributes 注 解 
@SessionAttributes(value = {"user"}) //Q) 
public class SessionAttributeController 


//2、@ModelAttribute 注 解 的 方法 进行 表单 引用 对 象 的 创建 
@ModelAttribute("user") //®© 
public UserModel initUser() 


//3、@RequestMapping 注 解 方 法 的 @ModelAttribute 注 解 的 参数 进行 命令 对 象 的 绑 定 
@RequestMapping("/session1") //® 
public String session1i(@ModelAttribute("user") UserModel] user) 
//4、 通 过 SessionStatus 的 setCcomplete( ) 方 法 清除 @SessionAttributes 指 定 的 会 话 数据 
@RequestMapping("/session2") //®) 
public String session(@ModelAttribute("user") UserModel user, SessionStatus status) { 

if(true) { //@ 

status.setComplete(); 
} 


return "success"; 


@SessionAttributes(value = {"user"})) 含 义 : 


@SessionAttributes(value = {"User"}) 标识 将 模型 数据 中 的 名 字 为 “User” 的 对 象 存储 到 会 话 中 

(默认 HttpSession) ， 此 处 value 指 定 将 模型 数据 中 的 哪些 数据 (名 字 进 行 匹 配 ) 存储 到 会 话 
中 ， 此 外 还 有 一 个 types 属 性 表示 模型 数据 中 的 哪些 类 型 的 对 象 存 储 到 会 话 范围 内 ， 如 果 同 时 
指定 value 和 types 属 性 则 那些 名 字 和 类 型 都 匹配 的 对 象 才 能 存储 到 会 话 范围 内 。 


包含 @SessionAttributes 的 执行 流程 如 下 所 示 : 


@ 首先 根据 @SessionAttributes 注 解 信息 查找 会 话 内 的 对 象 放 入 到 模型 数据 中 ; 


@ 执行 @ModelAttribute 注 解 的 方法 : 如 果 模 型 数据 中 包含 同名 的 数据 ， 则 不 执行 
@ModelAttribute 注 解 方法 进行 准备 表单 引用 数据 ， 而 是 使 用 @@ 步 骤 中 的 会 话 数据 ; 如 果 模 型 
数据 中 不 包含 同名 的 数据 ， 执 行 @ModelAttribute 注 解 的 方法 并 将 返回 值 添加 到 模型 数据 中 ; 


@ 执行 @RequestMapping 方 法 ， 绑 定 @ModelAttribute 注 解 的 参数 : 查找 模型 数据 中 是 否 有 
@ModelAttribute 注 解 的 同名 对 象 ， 如 果 有 直接 使 用 ， 否 则 通过 反射 创建 一 个 ; 并 将 请 求 参数 
绑 定 到 该 命令 对 象 ; 


此 处 需要 注意 : 如 果 使 用 @SessionAttributes 注 解 控制 器 类 之 后 ， 回 步骤 一 定 是 从 模型 对 象 中 
取得 同名 的 命令 对 象 ， 如 果 模 型 数据 中 不 存在 将 抛 出 HttpSessionRequiredException 
Expected session attribute user (Spring3.1) 


或 HttpSessionRequiredException Session attribute ‘user’ required - not found in 
session(Spring3.0) 弄 常 。 


@ 如 果 会 话 可 以 销毁 了 ， 如 多 交 表 单 的 最 后 一 步 ， 此 时 可 以 调用 SessionStatus 对 象 的 
setComplete() 标 识 当 前 会 话 的 ae 定 的 数据 可 以 清理 了 ， 此 时 当 
@RequestMapping 功 能 处 理 方法 执行 完毕 会 进行 清理 会 话 数据 。 


我 们 通过 Spring Web MVC 的 源 代码 验证 一 下 吧 ， 此 处 我 们 分 析 的 是 Spring3.1 的 
RequestMappingHandlerAdapter， 读 者 可 以 自行 验证 Spring3.0 的 
AnnotationMethodHandlerAdapter， 流 程 一 样 : 


(1、RequestMappingHandlerAdapterinvokeHandlerMethod 


//1、RequestMappingHandlerAdapter 首 先 调用 ModelFactory 的 jnitModel 方 法 准备 模型 数据 : 
modelFactory.initModel(webRequest, mavContainer, requestMappingMethod); 
//2、 调 用 @RequestMapping 注 解 的 功能 处 理 方 法 
requestMappingMethod.invokeAndHandle(webRequest, mavContainer); 

//3、 更 新 /合并 模型 数据 

modelFactory.updateModel(webRequest, mavContainer); 





(2、ModelFactory.initModel 


Map<String, ?> attributesInSession = this.sessionAttributesHandler.retrieveAttributes(req 
//1.1、 将 与 @SessionAttributes 注 解 相关 的 会 话 对 象 放 入 模型 数据 中 
mavContainer .mergeAttributes(attributesInSession)， 
//IL.2、 调 用 @Mode1lAttribute 方 法 添加 表单 引用 对 象 
invokeModelAttributeMethods(request, mavContainer); 
//1.3、 验 证 模型 数据 中 是 否 包 含 @SessionAttributes 注 解 相 关 的 会 话 对 象 ， 不 包含 抛 出 出 常 
for (String name : findSessionAttributeArguments(handlerMethod)) { 
if (!mavContainer.containsAttribute(name)) 
//1.4、 此 处 防止 在 @ModelAttribute 注 解 方法 又 添加 了 会 话 对 象 
// 如 在 @ModelAttribute 注 解 方 法 调用 session.setAttribute("user", new UserModel()); 
Object value = this.sessionAttributesHandler.retrieveAttribute(request, name); 
If (value == null) { 
throw new HttpSessionRequiredException("Expected session attribute '" + name 


mavContainer.addAttribute(name, value); 








(3、 ModelFactory.invokeModelAttributeMethods 


for (InvocableHandlerMethod attrMethod : this.attributeMethods) { 
String modelName = attrMethod.getMethodAnnotation(ModelAttribute.class).value( ); 
//1.2.1、 如 果 模 型 数据 中 包含 同名 数据 则 不 再 添加 
If (mavContainer.containsAttribute(modelName)) { 
continue; 


//1.2.2、 调 用 @ModelAttribute 注 解 方 法 并 将 返回 值 添加 到 模型 数据 中 ， 此 处 省 略 实现 代码 


(4、requestMappingMethod.invokeAndHandle 调用 功能 处 理 方 法 ， 此 处 省 略 


(5、ModelFactory.updateMode 更 新 模型 数据 


//3.1、 如 果 会 话 被 标识 为 完成 ， 此 时 从 会 话 中 清除 QSessionAttributes 注 解 相关 的 会 话 对 象 

if (mavContainer.getSessionStatus().isCcomplete()){ 
this.sessionAttributesHandler.cleanupAttributes(request); 

} 

//3.2、 如 果 会 话 没有 完成 ， 将 模型 数据 中 的 @SessionAttributes 注 解 相 关 的 对 象 添加 到 会 话 中 

else { 
this.sessionAttributesHandler.storeAttributes(request, mavContainer .getModel()); 


} 

// 省 略 部 分 代码 
到 此 @SessionAtrribute 介 绍 完毕 ， 测 试 代码 在 
cn.javass.chapter6.web.controller.paramtype.SessionAttributeController 中 。 


另外 cn.javass.chapter6.web.controller.paramtype.WizardFormController 是 一 个 类 似 于 
【4.11、AbstractWizardFormController】 中 介绍 的 多 步骤 表单 实现 ， 此 处 不 再 贴 代 码 ， 多 步 

又 提交 表单 需要 考虑 会 话 超时 间 题 ， 这 种 方式 可 能 对 用 户 不 太 友 好 ， 我 们 可 以 采取 隐藏 表单 
( 即 当前 步骤 将 其 他 步骤 的 表单 隐藏 ) 或 表单 数据 存 数据 库 (每 步骤 更 新 下 数据 库 数据 ) 等 
方案 解决 。 

6.6.8、@Value 绑 定 SpEL 表 示 式 

@Value 用 于 将 一 个 SpEL 表 达 式 结果 映射 到 到 功能 处 理 方 法 的 参数 上 。 


public String test(@Value("#{systemproperties['java.vm.version']}") String jvmVersion) 


到 此 数据 绑 定 我 们 就 介绍 完了 ， 对 于 没有 介绍 的 方法 参数 和 注解 ( 包括 自 定 义 注解 ) 在 后 续 
章节 进行 介绍 。 接 下 来 我 们 学 习 下 数据 类 型 转换 吧 。 


转载 请 注 明 出 处 【http://jinnianshilongnian.iteye.com/blog/1703694】 





SpringMVC 数 据 类 型 转换 一 一 第 七 草 注解 式 控制 
器 的 数据 验证 、 类 型 转换 及 格式 化 一 一 跟着 开 涛 学 
SpringMVC 


7.1、 简 介 


在 编写 可 视 化 界面 项 目 时 ， 我 们 通常 需要 对 数据 进行 类 型 转换 、 验 证 及 格式 化 。 


一 、 在 Spring3 之 前 ， 我 们 使 用 如 下 架构 进行 类 型 转换 、 验 证 及 格式 化 : 





(LyetAsText 
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流程 : 


@ : 类 型 转换 : 首先 调用 PropertyEditor 的 setAsText (String) ， 内 部 根据 需要 调用 
setValue(Object) 方 法 进行 设置 转换 后 的 值 ; 


@ : 数据 验证 : 需要 显示 调用 Spring 的 Validator 接 口 实现 进行 数据 验证 ; 
@ : 格式 化 显示 : 需要 调用 PropertyEditor 的 getText 进 行 格式 化 显示 。 


使 用 如 上 架构 的 缺点 是 : 








(1、PropertyEditor 被 设计 为 只 能 String< 一 >Object 之 间 转 换 ， 不 能 任意 对 象 类 型 < > 任 


意 类 型 ， 如 我 们 常见 的 Long 时 间 改 到 Date 类 型 的 转换 是 办 不 到 的 ; 


(2、PropertyEditor 是 线程 不 安全 的 ， 也 就 是 有 状态 的 ， 因 此 每 次 使 用 时 都 需要 创建 一 个 ， 
不 可 重用 ; 


(3、PropertyEditor 不 是 强 类 型 的 ，setValue (Object) 可 以 接受 任意 类 型 ， 因 此 需要 我 们 自 
己 判 断 类 型 是 否 兼容 ; 


(4、 需 要 自己 编程 实现 验证 ，Spring3 支 持 更 棒 的 注解 验证 支持 ; 
(5、 在 使 用 SpEL 表 达 式 语言 或 DataBinder 时 ， 只 能 进行 String<--->Object 之 间 的 类 型 转换 ; 


(6 、 不 支持 细 粒 度 的 类 型 转换 /格式 化 ， 如 UserModel 的 registerDate 需 要 转换 /格式 化 类 似 %``2012-05-01、`“d 


** 在 Spring Web MVC 环 境 中 ， 数 据 类 型 转换 、 验 证 及 格式 化 通常 是 这 样 使 用 的 : ** 
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流程 : 


(DD、 类 型 转换 : 首先 表单 数据 (全 部 是 字符 串 ) 通过 WebDataBinder 进 行 绑 定 到 命令 对 象 ， 内 部 通过 PropertyEditor 实 


@ : 数据 验证 : 在 控制 器 中 的 功能 处 理 方 法 中 ， 需 要 显示 的 调用 Spring 的 Validator 实 现 并 将 错 
误 信息 添加 到 BindingResult 对 象 中 ; 


@ : 格式 化 显示 : 在 表单 页 面 可 以 通过 如 下 方式 展示 通过 propertyEditor 格式 化 的 数据 和 错 
误 信息 : 


<%@taglib prefix="spring" uri="http://www.springframework.org/tags" %> 
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 


首先 需要 通过 如 上 taglib 指 令 引 入 spring 的 两 个 标签 库 。 


/V/I、 格 式 化 单个 命令 /表单 对 象 的 值 (好 像 比较 麻烦 ， 盖 心 没有 好 办 法 ) 
<spring:bind path="dataBinderTest.phoneNumber">${status.value}</spring:bind> 


//2、 通 过 form 标 签 ， 内 部 的 表单 标签 会 自动 调用 命令 /表单 对 象 属 性 对 应 的 PropertyEditor 进 行 格式 化 显示 
<form:form commandName="dataBinderTest"> 

<form:input path="phoneNumber"/><!-- 如 果 出 错 会 显示 错误 之 前 的 数据 而 不 是 空 --> 
</form:form> 


//3、 显 示 验 证 失败 后 的 错误 信息 
<form:errors></form:errors> 


如 上 PropertyEditor 和 验证 API 使 用 起 来 比较 麻烦 ， 而 且 有 许多 缺点 ， 因 此 Spring3 提 供 了 更 强 
大 的 类 型 转换 (Type Conversion) 支持 ， 它 可 以 在 任意 对 象 之 间 进 行 类 型 转换 ， 不 仅仅 是 


String< 一 一 >Object ; 也 提供 了 强大 的 数据 验证 支持 ; 同时 提供 了 强大 的 数据 格式 化 支持 。 





二 、 从 Spring3 开 始 ， 我 们 可 以 使 用 如 下 架构 进行 类 型 转换 、 验 证 及 格式 化 : 





Validation 
(JSR-303) 


@ : 类 型 转换 : 内 部 的 ConversionService 会 根据 S 源 类 型 TT 目标 类 型 自动 选择 相应 的 
Converter SPI 进 行 类 型 转换 ， 而 且 是 强 类 型 的 ， 能 在 任意 类 型 数据 之 间 进 行 转换 ; 


@ : 数据 验证 : 支持 JSR-303 验 证 框架 ， 如 将 @Valid 放 在 需要 验证 的 目标 类 型 上 即 可 ; 


@ : 格式 化 显示 : 其 实 就 是 任意 目标 类 型 ---->String 的 转换 ， 完 全 可 以 使 用 Converter SPI 完 
成 。 


Spring 为 了 更 好 的 诠释 格式 化 /解析 功能 提供 了 Formatter SPI， 支 持 根据 Locale 信 息 进 行 格式 
化 /解析 ， 而 且 该 套 SPI 可 以 支持 字段 /参数 级 别 的 细 粒 度 格 式 化 /解析 ， 流 程 如 下 : 


@ : 类 型 解析 (转换 ) : String---->T 类 型 目标 对 象 的 解析 ， 和 PropertyEditor 类 似 ; 
@ : 格式 化 显示 : 任意 目标 类 型 ---->String 的 转换 ， 和 PropertyEditor 类 似 。 


Formatter SPI 最 大 特点 是 能 进行 字段 /参数 级 别 的 细 粒 度 解 析 / 格 式 化 控制 ， 即 使 是 Converter 
SPI 也 是 粗 粒 度 的 〈( 到 某 个 具体 类 型 ， 而 不 是 其 中 的 某 个 字段 单独 控制 ) ， 目 前 Formatter SPI 
还 不 是 很 完善 ， 如 果 您 有 好 的 想法 可 以 到 Spring 官网 提 建 议 。 


Formatter SPI 内 部 实现 实际 委托 给 Converter SPI 进 行 转换 ， 即 约束 为 解析 /格式 化 String<----> 


任意 目标 类 型 。 


在 Spring Web MVC 环 境 中 ， 数 据 类 型 转换 、 验 证 及 格式 化 通常 是 这 样 使 用 的 : 
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(DD、 类 型 转换 : 首先 表单 数据 (全 部 是 字符 串 ) 通过 WebDataBinder 进 行 绑 定 到 命令 对 象 ， 内 部 通过 Converter SPI 实 性 


@ : 数据 验证 : 使 用 JSR-303 验 证 框架 进行 验证 ; 


@ : 格式 化 显示 : 在 表单 页 面 可 以 通过 如 下 方式 展示 通过 内 部 通过 Converter SPI 格式 化 的 数据 
和 错误 信息 : 


<%@taglib prefix="spring" uri="http://www.springframework.org/tags" %> 
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 


首先 需要 通过 如 上 taglib 指 令 引 入 spring 的 两 个 标签 库 。 
//1、 格 式 化 单个 命令 /表单 对 象 的 值 (好 像 比较 麻烦 ， 申 心 没有 好 办 法 ) 


<spring:bind path="dataBinderTest.phoneNumber">${status.value}</spring:bind> 


//2、<spring:eval> 标 签 ， 自 动 调用 ConversionService 并 选择 相应 的 Converter SPI 进 行 格 式 化 展示 
<spring:eval expression="dataBinderTest.phoneNumber"></spring:eval> 


如 上 代码 能 工作 的 前 提 是 在 RequestMappingHandlerMapping 配 置 了 
ConversionServiceExposinglnterceptor， 它 的 作用 是 暴露 conversionService 到 请 求 中 以 便 如 
<spring:eval> 标 签 使 用 。 


//3、 通 过 form 标 签 ， 内 部 的 表单 标签 会 自动 调用 命令 /表单 对 象 属 性 对 应 的 PropertyEditor 进 行 格式 化 显示 
<form:form commandName="dataBinderTest"> 

<form:input path="phoneNumber"/><!-- 如 果 出 错 会 显示 错误 之 前 的 数据 而 不 是 空 --> 
</form:form> 


//4、 显 示 验 证 失败 后 的 错误 信息 
<form:errors></form:errors> 


接 下 来 我 们 就 详细 学 习 一 下 这 些 知识 吧 。 
7.2、 数 据 类 型 转换 


7.2.1、Spring3 之 前 的 PropertyEditor 


PropertyEditor 介 绍 请 参考 【4.16.1、 数 据 类 型 转换 】。 
一 、 测 试 之 前 我 们 需要 准备 好 测试 环境 : 


(1、 模 型 对 象 ， 和 【4.16.1、 数 据 类 型 转换 】 使 用 的 一 样 ， 需 要 将 DataBinderTestModel 模 型 
类 及 相关 类 拷贝 过 来 放 入 cn.javass.chapter7.model 包 中 。 


(2、 控 制 器 定义 : 


package cn.javass.chapter7.web.controller ; 
// 省 略 import 
@Controller 
public class DataBinderTestController { 
@RequestMapping(value = "/dataBind") 
public String test(DataBinderTestModel command) { 
// 输 出 command 对 象 看 看 是 否 绑 定 正确 
System.out.println(command); 
model.addAttribute("dataBinderTest", command); 
return "bind/success"; 


(3、Spring 配 置 文件 定义 ， 请 参考 chapter7-servlet.xml， 并 注册 DataBinderTestController : 


<bean cJass="cn,javass,chapter7.web.controller.DataBinderTestController"/> 


(4、 测 试 的 URL : 


http://localhost:9080/springmvc-chapter7/dataBind? 
Username=zhang&bool=yes&schoolnfo.specialty=computer&hobbyList[0]=program&hobbyLi 
st[1]=music&map[key1]=value1&map[key2]=value2&phoneNumber=010- 
12345678&date=2012-3-18 16:48:48&state=blocked 


二 、 注 解 式 控制 器 注册 PropertyEditor : 
1、 使 用 WebDataBinder 进 行 控制 器 级 别 注 册 PropertyEditor (控制 器 独 享 ) 


@InitBinder 

// 此 处 的 参数 也 可 以 是 ServletRequestDataBinder 类 型 

public void initBinder(WebDataBinder binder) throws Exception { 
// 注 册 自 定义 的 属性 编辑 器 
//1、 日 期 
DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"); 
CustomDateEditor dateEditor = new CustomDateEditor(df, true); 
// 表 示 如 果 命 令 对 象 有 Date 类 型 的 属性 ， 将 使 用 该 属性 编辑 器 进行 类 型 转换 
binder.registerCustomEditor(Date.class, dateEditor); 
// 自 定义 的 电话 号 码 编辑 器 (和 【4.16.1、 数 据 类 型 转换 】 一 样 ) 
binder.registerCustomEditor(PhoneNumberModel.class, new PhoneNumberEditor()); 


和 【4.16.1、 数 据 类 型 转换 】 一 节 类 似 ， 只 是 此 处 需要 通过 @InitBinder 来 注册 自 定 义 的 
PropertyEditor ° 


2、 使 用 **webBindingInitializer 批 量 注册 ** PropertyEditor 
和 【4.16.1、 数 据 类 型 转换 】 不 太一 样 ， 因 为 我 们 的 注解 式 控制 器 是 POJO， 没 有 实现 任何 东 
西 ， 因 此 无 法 注入 WebBindinglnitializer， 此 时 我 们 需要 把 WebBindinglnitializer 注 入 到 我 们 的 


RequestMappingHandlerAdapter 或 AnnotationMethodHandlerAdapter， 这 样 对 于 所 有 的 注解 
式 控 制 器 都 是 共享 的 。 


<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerA 
<property name="webBindingInitializer"> 
<bean class="cn,javass.chapter7.web,.controller.Ssupport,initializer.MywebBindingInIitia 
</property> 
</bean> 


加 








此 时 我 们 注释 掉 控 制 器 级 别 通过 @InitBinder 注 册 PropertyEditor 的 方法 。 
3、 全 局 级 别 注 册 PropertyEditor (全 局 共享 ) 


和 【4.16.1、 数 据 类 型 转换 】 一 节 一 样 ， 此 处 不 再 重复 。 请 参考 【4.16.1、 数 据 类 型 转换 】 的 
【全 局 级 别 注 册 PropertyEditor (全 局 共享 ) 】。 


接 下 来 我 们 看 一 下 Spring3 提 供 的 更 强大 的 类 型 转换 支持 。 


7.2.2、Spring3 开 始 的 类 型 转换 系统 


Spring3 引 入 了 更 加 通用 的 类 型 转换 系统 ， 其 定义 了 SPI 接 口 (Converter 等 ) 和 相应 的 运行 时 
执行 类 型 转换 的 API (ConversionService 等 )， 在 Spring 中 它 和 PropertyEditor 功 能 类 似 ， 可 
以 替代 PropertyEditor 来 转换 外 部 Bean 属 性 的 值 到 Bean 属 性 需要 的 类 型 。 


该 类 型 转换 系统 是 Spring 通用 的 ， 其 定义 在 org.springframework.core.convert 包 中 ， 不 仅仅 在 
Spring Web MVC 场 景 下 。 目 标 是 完全 替换 PropertyEditor， 提 供 无 状态 、 强 类 型 且 可 以 在 任 
意 类 型 之 间 转 换 的 类 型 转换 系统 ， 可 以 用 于 任何 需要 的 地 方 ， 如 SpEL、 数 据 绑 定 。 


Converter SPI 完 成 通用 的 类 型 转换 逻辑 ， 如 java.util.Date<---->java.lang.Long 或 
java.lang.String---->PhoneNumberModel 等 。 


7.2.2.1、 架 构 


1、 类 型 转换 器 : 提供 类 型 转换 的 实现 支持 。 


Converter | YGenericConverter DConverterFactory<S, R> 
功 convert (5) T JJ) convert (0bject, TypeDescriptor, TypeDesecriptor) Object wD getConverter (Class<T)») Converter S, 1T> 
convertiblelypes Set ConvertiblePair> 
sD yp 


} 
了 ConditionalGenericConverter 


oD matches (TypeDescriptor, TypeDescriptor) boolean 


一 个 有 如 下 三 种 接口 : 


(1、Converter : 类 型 转换 器 ， 用 于 转换 S 类 型 到 T 类 型 ， 此 接口 的 实现 必须 是 线程 安全 的 且 
可 以 被 共享 。 


package org.springframework.core.convert.converter; 
public interface Converter<S，T> { //G) S 是 源 类 型 T 是 目标 类 型 
T convert(S source); //@ 转换 S 类 型 的 Source 到 T 目 标 类 型 的 转换 方法 


} 


示例 : 请 参考 cn.javass.chapter7.converter.support.StringToPhoneNumberConverter 转 换 
器 ， 用 于 将 String--->PhoneNumberModel。 


此 处 我 们 可 以 看 到 Converter 接 口 实现 只 能 转换 一 种 类 型 到 另 一 种 类 型 ， 不 能 进 # 
换 ， 如 将 一 个 数组 转换 成 集合 ， 如 (String[] ----> List<String>、String[]----- 
>List<PhoneNumberModel> 等 ) 。 


(2、GenericConverter 和 ConditionalGenericConverter : GenericConverter 接 口 实现 能 在 
多 种 类 型 之 间 进 行 转换 ，ConditionalGenericConverter 是 有 条 件 的 在 多 种 类 型 之 间 进 行 转换 。 


package org.springframework.core.convert.converter,; 
public interface GenericConverter { 
Set<ConvertiblePair> getConvertibleTypes(); 
Object convert(Object source, TypeDescriptor sourceType, TypeDescriptor targetType); 


} 
二 了 | 
getConvertibleTypes: 指 定 了 可 以 转换 的 目标 类 型 对 ; 


convert : 在 sourceType 和 targetType 类 型 之 间 进 行 转换 。 


package org.springframework.core.convert.converter,; 
public interface ConditionalGenericConverter extends GenericConverter { 
boolean matches(TypeDescriptor sourceType, TypeDescriptor targetType); 


} 


matches : 用 于 判断 sourceType 和 targetType 类 型 之 间 能 否 进 行 类 型 转换 。 


示例 : 如 org.springframework.core.convert.support.ArrayToCollectionConverter 和 
CollectionToArrayConverter 用 于 在 数组 和 集合 间 进 行 转换 的 ConditionalGenericConverter 实 
现 ， 如 在 String[]<---->List<String>、String[]<---->List<PhoneNumberModel> 等 之 间 进 行 类 型 


转换 。 
对 于 我 们 大 部 分 用 户 来 说 一 般 不 需要 自 定义 GenericConverter, 如 果 需 要 可 以 参考 内 置 的 
GenericConverter 来 实现 自己 的 。 

(3、ConverterFactory : 工厂 模式 的 实现 ， 用 于 选择 将 一 种 S 源 类 型 转换 为 R 类 型 的 子 类 型 下 
的 转换 器 的 工厂 接口 。 


package org,springframework.core.convert ,converter ; 


public interface ConverterFactory<S，R> { 
<T extends R> Converter<S，T> getConverter(Class<T> targetType); 


} 


S : 源 类 型 ; 民 目 标 类 型 的 父 类 型 ;和 : 目标 类 型 ， 且 是 民 类 型 的 子 类 型 ; 
getConverter : 得 到 目标 类 型 的 对 应 的 转换 器 。 


示例 : 如 org.springframework.core.convert.support.NumberToNumberConverterFactory 用 于 
在 Number 类 型 子 类 型 之 间 进 行 转换 ， 如 Integer--->Double ，Byte---->Integer ， Float--- 
>Double 等 。 


对 于 我 们 大 部 分 用 户 来 说 一 般 不 需要 自 定义 ConverterFactory， 如 果 需 要 可 以 参考 内 置 的 
ConverterFactory 来 实现 自己 的 。 

2、 类 型 转换 器 注册 器 、 类 型 转换 服务 : 提供 类 型 转换 器 注册 支持 ， 运 行 时 类 型 转换 API 支 
持 。 


(HConverterRegisitry | ConversionService 
D 注 册 类 型 转换 器 要 
| 加 使 用 类 型 转换 器 进行 类 型 转换 
地 下 ormatterReEistry 9 ConfigurableConversionService 
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一 共有 如 下 两 种 接口 : 


(1、ConverterRegistry : 类 型 转换 器 注册 支持 ， 可 以 注册 /删除 相应 的 类 型 转换 器 。 


package org.springframework.core.convert.converter,; 
public interface ConverterRegistry { 
void addConverter(Converter<?, ?> converter); 
void addConverter(Class<?> sourceType, Class<?> targetType, Converter<?, ?> converter 
void addConverter(GenericConverter converter); 
void addConverterFactory(ConverterFactory<?, ?> converterFactory); 
void removeConvertible(Class<?> sourceType, Class<?> targetType); 





可 以 注册 : Converter 实 现 ，GenericConverter 实 现 ，ConverterFactory 实 现 。 


(2、ConversionService : 运行 时 类 型 转换 服务 接口 ， 提 供 运 行 期 类 型 转换 的 支持 。 


package org.springframework.core.convert 
public interface ConversionService { 
boolean canConvert(Class<?> sourceType, Class<?> targetType); 
boolean canConvert(TypeDescriptor sourceType, TypeDescriptor targetType); 
<T> T convert(0bject source, Class<T> targetType); 
Object convert(0Object source, TypeDescriptor sourceType, TypeDescriptor targetType); 


} 
| 一 


convert : 将 源 对 象 转换 为 目标 类 型 的 目标 对 象 。 





Spring 提供 了 两 个 默认 实现 〈 其 都 实现 了 ConverterRegistry、ConversionService 接 口 ) : 
DefaultConversionService: 默 认 的 类 型 转换 服务 实现 ; 


DefaultFormattingConversionService : 带 数 据 格 式 化 支持 的 类 型 转换 服务 实现 ， 一 般 使 用 该 
服务 实现 即 可 。 


7.2.2.2、Spring 内 建 的 类 型 转换 器 如 下 所 示 : 


类 名 说 明 
第 一 组 : 标量 转换 器 


String----->Booleantrue:true/on/yes/1 ; 
false:false/off/no/0 


StringToBooleanConverter 
ObjectToStringConverter Object----->String 调 用 toString 方 法 转换 
StringJoNumberConverterFactory String----->Number (如 Integer、Long 等 ) 


Number 子 类 型 (Integer、Long、Double 等 )< 
> Number 子 类 型 (Integer、Long、Double 等 ) 





NumberToNumberConverterFactory 


String----->java.lang.Character 取 字符 串 第 一 个 字 


StringToCharacterConverter 符 








米 刑 ™ ™ 等 

NumberToCharacterConverter me ~ (nleger On Doubles) BE 

java.lang.Character 

java.lang.Character >Number 子 类 型 
CharacterToNumberFactory a 

: String----->enum 类 型 通过 Enum.valueOf 将 字符 

StringToEnumConverterFactory 囊 转换 为 需要 的 enum 类 型 
EnumToStringConverter enum 类 型 ----->String 返 回 enum 对 象 的 name() 值 
StringToLocaleConverter String----->java.util.Local 


java.util.Properties----->String 默 认 通 过 |SO- 


Properties ToStringConverter 8859-1 解 码 


String----->java.util.Properties 默 认 使 用 |SO- 


StringToPropertiesConverter 8859-1 编 码 


第 二 组 : 集合 、 数 组 相关 转换 器 
ArrayToCollectionConverter 
CollectionToArrayConverter 


ArrayToArrayConverter 
CollectionToCollectionConverter 


MapToMapConverter 
ArrayToStringConverter 


StringToArrayConverter 


ArrayToObjectConverter 


ObjectToArrayConverter 


Collection ToStringConverter 


StringToCollectionConverter 


Collection ToObjectConverter 


ObjectToCollectionConverter 


第 三 组 : 默认 (fallback) 转换 器 : 


之 前 的 转换 器 不 能 转换 时 调用 


ObjectToObjectConverter 


ldToEntityConverter 


FallbackObjectToStringConverter 


S : 代表 源 类 型 ，T : 代表 目标 类 型 


任意 S 数 组 ----> 任 意 T 集 合 (List、Set) 
任意 T 和 集合 (List、Set) ----> 任 意 S 数 组 
任意 S 数 组 <----> 任 意 T 数 组 


任意 T 集 合 (List、Set) <----> 任 意 T 集 合 (List、 
Set) 即 集合 之 间 的 类 型 转换 


Map<---->Map 之 间 的 转换 
任意 S 数 组 ---->String 类 型 


String-----> 数 组 默认 通过 “, ”分割 ， 且 去 除 字 符 串 
的 两 边 空格 (trim) 


任意 S 数 组 ----> 任 意 Object 的 转换 (如 果 目 标 类 型 
和 源 类 型 兼容 ， 直 接 返 回 源 对 象 ; 否则 返回 S 数 
组 的 第 一 个 元 素 并 进行 类 型 转换 ) 


Object-----> 单 元 素数 组 
任意 T 集 合 (List、Set) ---->String 类 型 


String-----> 集 合 (List、Set) 默认 通过 “,” 分 割 ， 
且 去 除 字符 串 的 两 边 空格 (trim) 


任意 T 集 合 ----> 任 意 Object 的 转换 (如 果 目 标 类 型 
和 源 类 型 兼容 ， 直 接 返 回 源 对 象 ; 否则 返回 S 数 
组 的 第 一 个 元 素 并 进行 类 型 转换 ) 


Object-----> 单 元 素 集合 


Object (S) ----- >Object (T) 首先 尝试 valueOf 
进行 转换 、 没 有 则 尝试 new 构造 器 (S) 


Id(S)----->Entity(T) 查 找 并 调用 public static T 
findEntityName 获 取 目 标 对 象 ，EntityName 是 T 类 
型 的 简单 类 型 


Object----->StringConversionService 作 为 恢复 使 
用 ， 即 其 他 转换 器 不 能 转换 时 调用 (执行 对 象 的 
toString() 方 法 ) 


如 上 的 转换 器 在 使 用 转换 服务 实现 DefaultConversionService 和 
DefaultFormattingConversionService 时 会 自动 注册 。 


7.2.2.3、 示 例 


(1、 自 定义 String----->PhoneNumberModel 的 转换 器 


package cn.javass.chapter7 .web.controller.support.converter; 
// 省 略 import 
public class StringToPhoneNumberConverter implements Converter<String, PhoneNumberModel> 
Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); 
Q@override 
public PhoneNumberModel convert(String Source) { 
if(!StringUtils.hasLength(source)) { 
/VD 如 果 Ssource 为 空 返回 null 
return null; 
} 
Matcher matcher = pattern.matcher(source); 
if(matcher.matches()) { 
// 避 如 果 匹 配 进行 转换 
PhoneNumberModel] phoneNumber = new PhoneNumberModel(); 
phoneNumber .setAreaCode(matcher .group(1)); 
phoneNumber .setPhoneNumber (matcher .group(2)); 
return phoneNumber; 
} else { 
/V/@) 如 果 不 匹配 转换 失败 
throw new IllegalArgumentException(String.format(" 类 型 转换 失败 ， 需 要 格式 [010-123< 





String 转 换 为 Date 的 类 型 转换 器 ， 请 参考 
cn.javass.chapter7.web.controller.support.converter. StringToDateConverter ° 


(2、 测 试用 例 (cn.javass.chapter7.web.controller.support.converter.ConverterTest) 


@Test 

public void testStringToPhoneNumberConvert() { 
DefaultConversionService conversionService = new DefaultConversionService(); 
conversionService.addConverter(new StringToPhoneNumberConverter()); 


String phoneNumberStr = "010-12345678"; 
PhoneNumberModel phoneNumber = conversionService.convert(phoneNumberStr, PhoneNumberM 


Assert.assertEquals("010", phoneNumber .getAreaCode()); 


四 


类 似 于 PhoneNumberEditor 将 字符 串 “010-12345678” 转 换 为 PhoneNumberModel。 





@Test 
public void testOtherConvert() { 
DefaultConversionService conversionService = new DefaultConversionService(); 


//"1"--->true (字符 串 “17 可 以 转换 为 布尔 值 true ) 
Assert.assertEquals(Boolean.valueof(true), conversionService.convert("1", Boolean.cla 


//"1,2,3,4"--->List (转换 完毕 的 集合 大 小 为 4) 


Assert.assertEquals(4, conversionService.convert("1,2,3,4", List.class).size()); 


} 
Ls 一 了 恶 一 


其 他 类 型 转换 器 使 用 也 是 类 似 的 ， 此 处 不 再 重复 。 





7.2.2.4、 集 成 到 Spring Web MVC 环 境 


(1、 注 册 ConversionService 实 现 和 自 定 义 的 类 型 转换 器 


<1-- 四 注册 ConversionService --> 
<bean id="conversionService" class="org.springframework.format.support. 
FormattingConversionServiceFactory 
<property name="converters"> 
<list> 
<bean class="cn.javass.chapter7 .web.controller.support. 
converter.StringToPhoneNumberConverter"/> 
<bean class="cn.javass.chapter7 .web.controller.support. 
converter.StringToDateConverter"> 
<constructor-arg value="yyyy-MM-dd"/> 
</bean> 
</list> 
</property> 
</bean> 


.4 3 





FormattingConversionServiceFactoryBean : 是 FactoryBean 实 现 ， 默 认 使 用 
DefaultFormattingConversionService 转 换 器 服务 实现 ; 


converters : 注册 我 们 自 定义 的 类 型 转换 器 ， 此 处 注册 了 String--->PhoneNumberModel 和 
String--->Date 的 类 型 转换 器 。 


(2、 通 过 ConfigurableWebBindinglnitializer 注 册 ConversionService 


<1-- @@ 使 用 ConfigurablewebBindingInitializer 注 册 conversionService --> 
<bean id="webBindingInitializer" class="org.springframework.web.bind.support. 
ConfigurablewebBi 
<property name="conversionService" ref="conversionService"/> 
</bean> 


IE 





此 处 我 们 通过 ConfigurableWebBindinglnitializer 绑 定 初始 化 器 进行 ConversionService 的 注 
册 ; 


3、 注 册 ConfigurableWebBindinglnitializer 到 RequestMappingHandlerAdapter 


<bean class="org.springframework.web.servlet.mvc.method.annotation. 
RequestMappingHandlerAdapter" 

<property name="webBindingInitializer" ref="webBindingInitializer"/> 

</bean> 


Dd 
通过 如 上 配置 ， 我 们 就 完成 了 Spring3.0 的 类 型 转换 系统 与 Spring Web MVC 的 集成 。 此 时 可 
以 启动 服务 器 输入 之 前 的 URL 测 试 了 。 


此 时 可 能 有 人 会 问 ， 如 果 我 同 We ee ， 执 和 Ue 
呢 ? 内 部 首先 查找 PropertyEditor 进 行 类 型 转换 ， 如 果 没 有 找到 相应 的 PropertyEditor 再 通 
ConversionService 进 行 转换 。 


如 上 集成 过 程 看 起 来 比较 麻烦 ， 后 边 我 们 会 介绍 <mvc:annotation-driven> 和 
@EnableWebMvc ，ConversionService 会 自动 注册 ， 后 续 章 节 再 详细 介绍 。 


跟 我 学 Spring 系列 


SpringMVC 数 据 类 型 转换 一 第 七 章 注解 式 控制 器 的 数据 验证 、 类 型 转换 及 格式 化 一 一 跟着 
开 涛 学 SpringMVC 608 





SpringMVC 数 据 格 式 化 一 一 第 七 章 注解 式 控制 器 
的 数据 验证 、 类 型 转换 及 格式 化 一 一 跟着 开 涛 学 
SpringMVC 


7.3、 数 据 格 式 化 


在 如 Web /客户 端 项 目 中 ， 通 常 需要 将 数据 转换 为 具有 某 种 格式 的 字符 串 进 行 展示 ， 因 此 上 和 节 
我 们 学 习 的 数据 类 型 转换 系统 核心 作用 不 是 完成 这 个 需求 ， 因 此 Spring3 引 入 了 格式 化 转换 器 
(Formatter SPI) 和 格式 化 服务 APIl (FormattingConversionService) 从 而 支持 这 种 需求 。 
在 Spring 中 它 和 PropertyEditor 功 能 类 似 ， 可 以 替代 PropertyEditor 来 进行 对 象 的 解析 和 格式 

化 ， 而 且 支 持 细 粒 度 的 字段 级 别 的 格式 化 /解析 。 


Formatter SPI 核 心 是 完成 解析 和 格式 化 转换 逻辑 ， 在 如 Web 应 用 /客户 端 项 目 中 ， 需 要 解析 、 
打印 /展示 本 地 化 的 对 象 值 时 使 用 ， 如 根据 Locale 信 息 将 java.util.Date---->java.lang.String 打 
印 /展示 、java.lang.String---->java.util.Date 等 。 


该 格式 化 转换 系统 是 Spring 通 用 的 ， 其 定义 在 org.springframework.format 包 中 ， 不 仅仅 在 
Spring Web MVC 场 景 下 。 


7.3.1、 架 构 


1、 格 式 化 转换 器 : 提供 格式 化 转换 的 实现 支持 。 


DPrinter<I> | 也 ParserCT》 | DAnnotationFormatterFactoryC...> 


好 print(T, Locale) String WW parse (String, Locale) T 喝 getFieldTypes1) Set<Class<?> 


全 oD getPrinter (A Class®?)) Printer ?> 
| WD) eetParser (A, [Class 人 ?)) Par ser ©?) 


UFormatter <T> 








一 共有 如 下 两 组 四 个 接口 : 
(1、Printer 接 口 : 格式 化 显示 接口 ， 将 T 类 型 的 对 得 根据 Locale 信 息 以 某 种 格式 进行 打印 显 


示 ( 即 返回 字符 囊 形式 ) ; 


package org.springframework.format; 
public interface Printer<T> { 
String print(T object, Locale locale); 


(2、Parser 接 口 : 解析 接口 ， 根 据 Locale 信 息 解 析 字 符 串 到 T 类 型 的 对 象 ; 


package org.springframework .format 
public interface Parser<T> { 
T parse(String text, Locale locale) throws ParseException; 


解析 失败 可 以 抛 出 java.text.ParseException 或 legalArgumentException 异 常 即 可 。 


(3、Formatter 接 口 : 格式 化 SP| 接 口 ， 继 承 Printer 和 Parser 接 口 ， 完 成 T 类 型 对 象 的 格式 化 
和 解析 功能 ; 


package org.springframework.format; 
public interface Formatter<T> extends Printer<T>, Parser<T> { 


} 


(4、AnnotationFormatterFactory 接 口 : 注解 驱动 的 字段 格式 化 工厂 ， 用 于 创建 带 注解 的 
对 象 字 段 的 Printer 和 Parser， 即 用 于 格式 化 和 解析 带 注 解 的 对 象 字段 。 


package org.springframework.format; 

public interface AnnotationFormatterFactory<A extends Annotation> {//Q 可 以 识别 的 注解 类 型 
Set<Class<?>> getFieldTypes();//@ 可 以 被 A 注解 类 型 注解 的 字段 类 型 集合 
Printer<?> getPrinter(A annotation，Class<?> fieldType);//(3 根 据 A 注 解 类 型 和 fieldType 类 型 
Parser<?> getParser(A annotation，Class<?> fieldType);// 了 根据 A 注解 类 型 和 fieldType 类 型 获 | 





返回 用 于 格式 化 和 解析 被 和 A 注解 类 型 注解 的 字段 值 的 Printer 和 Parser。 如 
JodaDateTimeFormatAnnotationFormatterFactory 可 以 为 带 有 @DateTimeFormat 注 解 的 
java.util.Date 字 段 类 型 创建 相应 的 Printer 和 Parser 进 行 格式 化 和 解析 。 


2、 格 式 化 转换 器 注册 器 、 格 式 化 服务 : 提供 类 型 转换 器 注册 支持 ， 运 行 时 类 型 转换 AP| 支 
持 。 


SN 


人 注册 格 式 化 转换 器 过 


tt | @ Frinter G> | py ] 


(UFormatterReegistry | 
上 而 


DFormatter<I> | 


[ 1】 @ 使 用 格式 化 转换 器 进行 格式 化 
(DJ FormattineConversionService 
一 ~ \D AnnotationFormatterFactory<. ..> 
人 疤 eetFieldlypes () Set <Class?)> 
el eetPrinter (A Class<?>) Printer<?> | 


虹 BetParser 八 ，Class<?7>) Parser<?> | 





SB DefaultFormattineConversionService 





一 个 有 如 下 两 种 接口 : 


(1、FormatterRegistry : 格式 化 转换 器 注册 器 ， 用 于 注册 格式 化 转换 器 (Formatter、Printer 
和 Parser、AnnotationFormatterFactory) ; 


package org.springframework.format; 
public interface FormatterRegistry extends ConverterRegistry { 
//Q 中 添加 格式 化 转换 器 (Spring3.1 新 增 API) 
void addFormatter(Formatter<?> formatter); 
/VC 为 指定 的 字段 类 型 添加 格式 化 转换 器 
void addFormatterForFieldType(Class<?> fieldType, Formatter<?> formatter ) ， 
//G@) 为 指定 的 字段 类 型 添加 Printer 和 Parser 
void addFormatterForFieldType(Class<?> fieldType, Printer<?> printer, Parser<?> parse 
// 包 添加 注解 驱动 的 字段 格式 化 工厂 AnnotationFormatterFactory 
void addFormatterForFieldAnnotation( 
AnnotationFormatterFactory<? extends Annotation> annotationFormatterFacto 





(2、FormattingConversionService : 继承 自 ConversionService， 运 行 时 类 型 转换 和 格式 
化 服务 接口 ， 提 供 运行 期 类 型 转换 和 格式 化 的 支持 。 


FormattingConversionService 内 部 实现 如 下 图 所 示 : 


Printer 
PrinterConverter Formatter 


p 
Par serConverter WP 


Formatt ingConver sionService 


convert () 方 法 


Annotat ionPr interConverter 


5 AnnotationFormatterFactory 
Annotat ionPar ser Gonver ter 


我 们 可 以 看 到 FormattingConversionService 内 部 实现 如 上 所 示 ， 当 你 调用 convert 方 法 时 : 
是 S 类 型 ----->String : 调用 私有 的 静态 内 部 类 PrinterConverter， 其 又 调用 相应 的 Printer 的 
实现 进行 格式 化 ; 


(2) 若 是 String----->T 类 型 : 调用 私有 的 静态 内 部 类 ParserConverter， 其 又 调用 相应 的 Parser 的 


(3) 若 是 A 注解 类 型 注解 的 S 类 型 ----->String : 调用 私有 的 静态 内 部 类 
AnnotationPrinterConverter， 其 又 调用 相应 的 AnnotationFormatterFactory 的 getPrinter 获 取 
Printer 的 实现 进行 格式 化 ; 


(若是 String----->A 注 解 类 型 注解 的 T 类 型 : 调用 私有 的 静态 内 部 类 
AnnotationParserConverter， 其 又 调用 相应 的 AnnotationFormatterFactory 的 getParser 获 取 
Parser 的 实现 进行 解析 。 


注 : S 类 型 表示 源 类 型 ，T 类 型 表示 目标 类 型 ， 人 表示 注解 类 型 。 


此 处 可 以 可 以 看 出 之 前 的 Converter SPI 完 成 任意 Object 与 Object 之 间 的 类 型 转换 ， 而 
Formatter SPI 完 成 任意 Object 与 String 之 问 的 类 型 转换 〈 即 格式 化 和 解析 ， 与 PropertyEditor 
类 似 ) 。 


7.3.2、Spring 内 建 的 格式 化 转换 器 如 下 所 示 : 


类 名 说 明 
DateFormatter i 实现 日 期 
NumberFormatter J J ， 实现 
CurrencyFormatter ， 0 0 
PercentFormatter java.lang.Number<---->String 实 现 


百分数 样式 的 格式 化 /解析 


@NumberFormat 注 解 类 型 的 数字 

字段 类 型 <---->String@ 通 过 

@NumberFormat 指 定格 式 化 /解析 
NumberFormatAnnotationFormatterFactory 格式 加 可 以 格式 化 /解析 的 数字 类 

型 : Short、|nteger、Long、 

Float 、 Double、BigDecimal、 

Biglnteger 


@DateTimeFormat 注 解 类 型 的 日 
期 字段 类 型 <---->String@ 通 过 
@DateTimeFormat 指 定格 式 化 / 解 
析 格 式 加 可 以 格式 化 /解析 的 日 期 类 
型 : joda 中 的 日 期 类 型 

(org.joda.time 包 中 的 ) 
LocalDate 、LocalDateTime、 
LocalTime 、 Readablelnstantjava 
内 置 的 日 期 类 型 : Date、 
Calendar、Longclasspath 中 必须 
有 Joda-Time 类 库 ， 否 则 无 法 格式 
化 日 期 类 型 


JodaDateTimeFormatAnnotationFormatterFactory 


NumberFormatAnnotationFormatterFactory 和 
JodaDateTimeFormatAnnotationFormatterFactory (如 果 classpath 提 供 了 Joda-Time 类 库 ) 
在 使 用 格式 化 服务 实现 DefaultFormattingConversionService 时 会 自动 注册 。 


7.3.3、 示 例 


在 示例 之 前 ， 我 们 需要 到 http://joda-time.sourceforge.net/ 下 载 Joda-Time 类 库 ， 本 书 使 用 的 是 
joda-time-2.1 版 本 ， 将 如 下 jar 包 添加 到 classpath : 


joda-time-2.1.jar 


7.3.3.1、 类 型 级 别 的 解析 /格式 化 


直接 使 用 Formatter SPI 进 行 解析 /格式 化 


// 二 、CurrencyFormatter : 实现 货币 样式 的 格式 化 /解析 

CurrencyFormatter currencyFormatter = new CurrencyFormatter(); 
currencyFormatter.setFractionDigits(2);// 保 留 小 数 点 后 几 位 
currencyFormatter.setRoundingMode(RoundingMode .CEILING);// 全 入 模式 (ceilling 表 示 四 使 五 入 ) 


//IL、 将 带 货 币 符号 的 字符 串 “$123 .125” 转 换 为 BigDecimal("123.00") 

Assert.assertEquals(new BigDecimal("123.13")，currencyFormatter .parse("$123.125"，Locale， 
//2、 将 BigDecimal("123") 格 式 化 为 字符 串 “$123 .909 展示 

Assert.assertEquals("$123.00", currencyFormatter.print(new BigDecimal("123"), Locale.US)) 
Assert.assertEquals(" 芝 123.00", currencyFormatter.print(new BigDecimal("123"), Locale.CcHIl 
Assert.assertEquals(" 芋 123.00", currencyFormatter.print(new BigDecimal("123"), Locale.JAP, 


1 一 








parse 方 法 : 将 带 格式 的 字符 串 根据 Locale 信 息 解 析 为 相应 的 BigDecimal 类 型 数据 ; 
print 方 法 : 将 BigDecimal 类 型 数据 根据 Locale 信 息 格 式 化 为 字符 串 数 据 进行 展示 。 
不 同 于 Convert SPI，Formatter SPI 可 以 根据 本 地 化 (Locale) 信息 进行 解析 /格式 化 。 


其 他 测试 用 例 请 参考 cn.javass.chapter7.web.controller.support.formatter.InnerFormatterTest 
的 testNumber 测 试 方法 和 testDate 测 试 方法 。 


@Test 

public void testwithDefaultFormattingConversionService() { 
DefaultFormattingConversionService conversionService = new DefaultFormattingConversio 
// 默 认 不 自动 注册 任何 Formatter 
CurrencyFormatter currencyFormatter = new CurrencyFormatter(); 
currencyFormatter .setFractionDigits(2);// 保 留 小 数 点 后 几 位 
currencyFormatter .setRoundingMode(RoundingMode .CEILING) ;// 仿 入 模式 〈cei1l1ing 表 示 四 伟 五 入 ， 
// 注 册 Formatter SPI 实 现 
conversionService.addFormatter(currencyFormatter ) 


// 绑 定 Locale 信 息 到 ThreadLocal 

//FormattingConversionService 内 部 自动 获取 作为 Locale 信 息 ， 如 果 不 设 值 默 认 是 Locale .getDefault 
LocaleContextHolder.setLocale(Locale.US); 

Assert.assertEquals("$1,234.13", conversionService.convert(new BigDecimal("1234.128") 
LocaleContextHolder.setLocale(null); 


LocaleContextHolder.setLocale(Locale.CcCHINA); 
Assert.assertEquals("¥1,234.13", conversionService.convert(new BigDecimal("1234.: 


Assert.assertEquals(new BigDecimal("1234.13"), conversionService.convert("¥1,234.13" 
LocaleContextHolder.setLocale(null);} 


Le 王立 一 一 ; 


DefaultFormattingConversionService : 带 数 据 格式 化 功能 的 类 型 转换 服务 实现 ; 





conversionService.addFormatter() : 注册 Formatter SPI 实 现 ; 


ee IE BigDecimal("1234.128"), String.class) : 用 于 将 BigDecimal 
类 型 数据 格式 化 为 字符 串 类 型 ， 此 处 根据 “LocaleContextHolder.setLocale(locale)" 设 置 的 本 地 
化 信息 进行 格式 化 ; 


AAS EAIGLLOA 全 234.13", BigDecimal.class) : 用 于 将 字符 串 类 型 数据 解析 为 
BigDecimal 类 型 数据 ， 此 处 也 是 根据 “LocaleContextHolder.setLocale(locale)" 设 置 的 本 地 化 信 
息 进行 解 ; 


LocaleContextHolder.setLocale(locale) : 设置 本 地 化 信息 到 ThreadLocal， 以 便 Formatter SPI 
根据 本 地 化 信息 进行 解析 /格式 化 ; 


具体 测试 代码 请 参考 cn.javass.chapter7.web.controller.support.formatter.InnerFormatterTest 
的 testWithDefaultFormattingConversionService 测 试 方法 。 


三 、 自 定义 Formatter 进 行 解析 /格式 化 
此 处 以 解析 /格式 化 PhoneNumberModel| 为 例 。 


(1、 定 义 Formatter SPI 实 现 


package cn.javass,chapter7.web.controller,.Ssupport .formatter ; 
// 省 略 import 
public class PhoneNumberFormatter implements Formatter<PhoneNumberModel> { 
Pattern pattern = Pattern.compile("^(\\d{3,4})-(\\d{7,8})$"); 
Q@Override 
public String print(PhoneNumberModel phoneNumber, Locale locale) {//QD 格 式 化 
if(phoneNumber == null) { 
return ™"; 
} 


return new StringBuilder().append(phoneNumber .getAreaCode()).append("-") 


.append(phoneNumber .getPhoneNumber()).toSstring(); 
} 


Q@Override 
public PhoneNumberModel parse(String text, Locale locale) throws ParseException {//®. 
if(!StringUtils.hasLength(text)) { 
//(D 如 果 source 为 空 返回 null 
return null; 
} 
Matcher matcher = pattern.matcher(text); 
if(matcher.matches()) { 
// 避 如 果 匹 配 进行 转换 
PhoneNumberModel phoneNumber = new PhoneNumberModel(); 
phoneNumber .setAreaCode(matcher .group(1)); 
phoneNumber .setPhoneNumber(matcher .group(2)); 
return phoneNumber; 
} else { 
/V/G@ 如 果 不 匹 配 转换 失败 


throw new IllegalArgumentException(String.format(" 类 型 转换 失败 ， 需 要 格式 [010-123< 





类 似 于 Convert SPI 实 现 ， 只 是 此 处 的 相应 方法 会 传 入 Locale 本 地 化 信息 ， 这 样 可 以 为 不 同 地 
区 进行 解析 /格式 化 数据 。 


(2、 测 试用 例 : 


package cn.javass,chapter7.web.controller.Ssupport ,formatter ; 
// 省 略 import 
public class CustomerFormatterTest { 
@Test 
public void test() { 
DefaultFormattingConversionService conversionService = new DefaultFormattingConve 
conversionService.addFormatter(new PhoneNumberFormatter()); 


PhoneNumberModel phoneNumber = new PhoneNumberModel("010", "12345678"); 
Assert.assertEquals("010-12345678", conversionService.convert(phoneNumber, String 


Assert.assertEquals("010", conversionService.convert("010-12345678", PhoneNumberM 








通过 PhoneNumberFormatter 可 以 解析 String--->PhoneNumberModel 和 格式 化 
PhoneNumberModel--->String。 


到 此 ， 类 型 级 别 的 解析 /格式 化 我 们 就 介绍 完了 ， 从 测试 用 例 可 以 看 出 类 型 级 别 的 是 对 项 目 中 
的 整个 类 型 实施 相同 的 解析 /格式 化 逻辑 。 


有 的 同学 可 能 需要 在 不 同 的 类 的 字段 实施 不 同 的 解析 /格式 化 逻辑 ， 如 用 户 模型 类 的 注册 日 期 
字段 只 需要 如 *2012-05-02" 格 式 进 行 解析 /格式 化 即 可 » 而 订单 模型 类 的 下 订单 日 期 字段 可 能 
需要 如 “2012-05-02 20 : 13 : 13” 格 式 进行 展示 。 


接 下 来 我 们 学 习 一 下 如 何 进 行 字 段 级 别 的 解析 /格式 化 吧 。 


7.3.3.2、 字 段 级 别 的 解析 /格式 化 
一 、 使 用 内 置 的 注解 进行 字段 级 别 的 解析 /格式 化 : 


(1、 测 试 模型 类 准备 : 


package cn.javass.chapter7.model; 

public class FormatterModel { 
@NumberFormat(style=Style.NUMBER, pattern="#,###") 
private int totalCount; 
@NumberFormat(style=Style.PERCENT) 
private double discount; 
@NumberFormat(style=Style .CURRENCY) 
private double sumMoney; 


@DateTimeFormat (iso=ISO .DATE) 
private Date registerDate; 


@DateTimeFormat(pattern="yyyy-MM-dd HH:mm:ss") 
private Date orderDate; 


// 省 略 getter/setter 


此 处 我 们 使 用 了 Spring 字段 级 别 解析 /格式 化 的 两 个 内 置 注 解 : 


@Number : 定义 数字 相关 的 解析 /格式 化 元 数据 (通用 样式 、 货 币 样式 、 百 分 数 样式 ) ， 参 数 
如 下 : 


style : 用 于 指定 样式 类 型 ， 包 括 三 种 : Style.NUMBER (通用 样式 ) Style.CURRENCY ( 货 
币 样 式 ) Style.PERCENT (百分数 样式 ) ， 默 认 Style.NUMBER ; 


pattern : 自 定义 样式 ， 如 patter="#,###" ; 
@DateTimeFormat : 定义 日 期 相关 的 解析 /格式 化 元 数据 ， 参 数 如 下 : 
pattern : 指定 解析 /格式 化 字段 数据 的 模式 ， 如 ”yyyy-MM-dd HH:mm:ss” 


iso : 指定 解析 /格式 化 字段 数据 的 ISO 模式 ， 包 括 四 种 : ISO.NONE (不 使 用 ) 
ISO.DATE(yyyy-MM-dd) ISO.TIME(hh:mm:ss.SSSZ) ISO.DATE_ TIME(yyyy-MM-dd 
hh:mm:ss.SSSZ)， 上 默认 ISO.NONE ; 


style : 指定 用 于 格式 化 的 样式 模式 ， 默 认 “SS”， 上 有 具体 使 用 请 参考 Joda-Time 类 库 的 
org.joda.time.format.DateTimeFormat 的 forStyle 的 javadoc ; 


优先 级 : pattern 大 于 iso 大 于 style。 


(2、 测 试用 例 : 


@Test 
public void test() throws SecurityException, NoSuchFieldException { 
// 默 认 自动 注册 对 @NumberFormat 和 @DateTimeFormat 的 支持 
DefaultFormattingConversionService conversionService = 
new DefaultFormattingConversionService(); 


// 准 备 测试 模型 对 象 

FormatterModel model = new FormatterModel(); 
model.setTotalCount (10000); 

model.setDiscount(0.51); 

model.setSumMoney(10000.13); 

model.setRegisterDate(new Date(2012-1900, 4, 1)); 
model.setorderDate(new Date(2012-1900, 4, 1, 20, 18, 18)); 


// 获 取 类 型 信息 
TypeDescriptor descriptor = 


new TypeDescriptor(FormatterModel.class.getDeclaredField("totalCcount")); 
TypeDescriptor stringDescriptor = TypeDescriptor.valueof(String.class); 


Assert.assertEquals("10,000", conversionService.convert(model.getTotalCount(), descri 
Assert.assertEquals(model.getTotalCount(), conversionService.convert("10,000", string 


-| 


TypeDescriptor : 拥有 类 型 信息 的 上 下 文 ， 用 于 Spring3 类 型 转换 系统 获取 类 型 信息 的 (可 以 
包含 类 、 字 段 、 方 法 参数 、 属 性 信息 ) ; 通过 TypeDescriptor， 我 们 就 可 以 获取 (类 、 字 段 、 
方法 参数 、 属 性 ) 的 各 种 信息 ， 如 注解 类 型 信息 ; 





conversionService.convert(model.getTotalCount(), descriptor, stringDescriptor) : 将 
totalCount 格 式 化 为 字符 串 类 型 ， 此 处 会 根据 totalCount 字 段 的 注解 信息 (通过 descriptor 对 象 
获取 ) 来 进行 格式 化 ; 


conversionService.convert("10,000", stringDescriptor, RN : 将 字符 串 “10,000” 解 析 为 
totalCount 字 段 类 型 ， 此 处 会 根据 totalCount 字 段 的 注解 信息 (通过 descriptor 对 象 获 取 ) 来 进 
行 解析 。 


(3、 通 过 为 不 同 的 字段 指定 不 同 的 注解 信息 进行 字段 级 别 的 细 粒 度数 据 解析 /格式 化 


descriptor = new TypeDescriptor(FormatterModel.class.getDeclaredField("registerDate")); 
Assert.assertEquals("2012-05-01", conversionService.convert(model.getRegisterDate(), desc 
Assert.assertEquals(model.getRegisterDate(), conversionService.convert("2012-05-01", stri 


descriptor = new TypeDescriptor(FormatterModel.class.getDeclaredField("orderDate")); 
Assert.assertEquals("2012-05-01 20:18:18", conversionService.convert(model.getOrderDate() 
Assert.assertEquals(model.getOorderDate(), conversionService.convert("2012-05-01 20:18:18" 


凤 本 二 


通过 如 上 测试 可 以 看 出 ， 我 们 可 以 通过 字段 注解 方式 实现 细 粒 度 的 数据 解析 /格式 化 控制 ， 但 
en 息 ， 即 编程 实现 字段 的 数据 解析 /格式 化 比 
较 麻 烦 。 





其 他 测试 用 例 请 参考 
cn.javass.chapter7.web.controller.support.formatter.InnerFieldFormatterTest 的 test 测 试 方 
法 。 


二 、 自 定义 注解 进行 字段 级 别 的 解析 /格式 化 : 
此 处 以 解析 /格式 化 PhoneNumberModel 字 段 为 例 。 


(1、 定 义 解 析 / 格 式 化 字段 的 注解 类 型 : 


package cn.javass,chapter7.web.controller.Ssupport ,formatter ; 

// 省 略 import 

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER}) 
@Retention(RetentionPolicy .RUNTIME) 

public @interface PhoneNumber { 


} 


(2、 实 现 AnnotationFormatterFactory 注 解 格 式 化 工厂 : 


package cn.javass,chapter7.web.controller,.Ssupport ,formatter ; 
// 省 略 import 
public class PhoneNumberFormatAnnotationFormatterFactory 


implements AnnotationFormatterFactory<PhoneNumber> {//Q 指 定 可 以 解析 /格式 化 的 字段 注解 类 型 


private final Set<Class<?>> fieldTypes; 
private final PhoneNumberFormatter formatter; 
public PhoneNumberFormatAnnotationFormatterFactory() { 
Set<Class<?>> set = new HashSet<Class<?>>(); 
set.add(PhoneNumberModel .class); 
this.fieldTypes = set; 
this.formatter = new PhoneNumberFormatter();// 此 处 使 用 之 前 定义 的 Formatter 实 现 


} 

/VCG) 指 定 可 以 被 解析 /格式 化 的 字段 类 型 集合 

Q@override 

public Set<Class<?>> getFieldTypes() { 
return fieldTypes; 

} 

//( 加 根据 注解 信息 和 字段 类 型 获取 解析 器 

Q@Override 

public Parser<?> getParser(PhoneNumber annotation, Class<?> fieldType) { 
return formatter; 


} 

// 四 根据 注解 信息 和 字段 类 型 获取 格式 化 器 

Q@override 

public Printer<?> getPrinter(PhoneNumber annotation, Class<?> fieldType) { 
return formatter; 


} 


本 芋 se 汪 汪 
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AnnotationFormatterFactory 实 现 会 根据 注解 信息 和 字段 类 型 获取 相应 的 解析 器 /格式 化 器 。 


(3、 修 改 FormatterModel 添 加 如 下 代码 : 


@PhoneNumber 


private PhoneNumberModel phoneNumber ; 


(4、 测 试用 例 


@Test 
public void test() throws SecurityException, NoSuchFieldException { 


DefaultFormattingConversionService conversionService = 
new DefaultFormattingConversionService();// 创 建 格 2 
conversionService.addFormatterForFieldAnnotation( 
new PhoneNumberFormatAnnotationFormatterFactory());// 添 加 自 定义 的 注解 格 z 


FormatterModel model = new FormatterModel(); 
TypeDescriptor descriptor = 

new TypeDescriptor(FormatterModel.class.getDeclaredField("phoneNumber")); 
TypeDescriptor stringDescriptor = TypeDescriptor.valueof(String.class); 


PhoneNumberModel value = (PhoneNumberModel) conversionService.convert("010-12345678", 
model.setPhoneNumber (value); 


Assert.assertEquals("010-12345678", conversionService.convert(model.getPhoneNumber(), 
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此 处 使 用 DefaultFormattingConversionService 的 addFormatterForFieldAnnotation 注 册 自 定义 
的 注解 格式 化 工厂 PhoneNumberFormatAnnotationFormatterFactory。 


集成 到 Spring Web MVC 环 境 中 。 


7.3.4、 集 成 到 Spring Web MVC 环 境 
一 、 注 册 FormattingConversionService 实 现 和 自 定义 格式 化 转换 器 : 


<bean id="conversionService" 
class="org.springframework.format.support.FormattingConversionServiceFactoryBean"> 
<! 一 此 处 省 略 之 前 注册 的 自 定义 类 型 转换 器 - -> 
<property name="formatters"> 
<list> 
<bean class="cn.javass.chapter7 .web.controller.support.formatter. 
PhoneNumberFormatAnnotat 
</list> 
</property> 
</bean> 
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其 他 配置 和 之 前 学 习 7.2.2.4 一 节 一 样 。 
二 、 示 例 : 


(1、 模 型 对 象 字段 的 数据 解析 /格式 化 : 


@RequestMapping(value = "/format1") 

public String test1(@ModelAttribute("model") FormatterModel formatModel) { 
return "format/success"; 

} 


totalCount:<spring:bind path="model.totalCount">${status.value}</spring:bind><br/> 
discount:<spring:bind path="model.discount">${status.value}</spring:bind><br/> 
sumMoney:<spring:bind path="model.sumMoney">${status.value}</spring:bind><br/> 
phoneNumber:<spring:bind path="model.phoneNumber">${status.value}</spring:bind><br/> 

<1-- 如 果 没 有 配置 org .springframework.web.servlet.handler.ConversionServiceExposingIntercept 
phoneNumber:<spring:eval expression="model.phoneNumber"></spring:eval><br/> 


<br/><br/> 

<form:form commandName="model"> 
<form:input path="phoneNumber"/><br/> 
<form:input path="sumMoney"/> 

</form:form> 


IE 





在 浏览 器 输入 测试 URL : 


http://localhost:9080/springmvc-chapter7/format1? 
totalCount=100000&discount=0.51&sumMoney=100000.128&phoneNumber=010-12345678 


数据 会 正确 绑 定 到 我 们 的 formatModel， 即 请 求 参 数 能 被 正确 的 解析 并 绑 定 到 我 们 的 命令 对 象 
上 ， 而 且 在 JSP 页 面 也 能 正确 的 显示 格式 化 后 的 数据 〈 即 正确 的 被 格式 化 显示 ) 。 


《2、 功 能 处 理 方 法 参数 级 别 的 数据 解析 : 


@RequestMapping(value = "/format2") 

public String test2( 
@PhoneNumber @RequestParam("phoneNumber") PhoneNumberModel phoneNumber, 
@DateTimeFormat(pattern="yyyy-MM-dd") @RequestParam("date") Date date) { 
System.out.println(phoneNumber); 
System.out.println(date); 
return "format/success2"，; 


此 处 我 们 可 以 直接 在 功能 处 理 方法 的 参数 上 使 用 格式 化 注解 类 型 进行 注解 ，Spring Web MVC 
能 根据 此 注解 信息 对 请 求 参数 进行 解析 并 正确 的 绑 定 。 


在 浏览 器 输入 测试 URL : 


http://localhost:9080/springmvc-chapter7/format2?phoneNumber=010- 
12345678&date=2012-05-01 


数据 会 正确 的 绑 定 到 我 们 的 phoneNumber 和 date 上 ， 即 请 求 的 参数 能 被 正确 的 解析 并 绑 定 到 
我 们 的 参数 上 。 


控制 器 代码 位 于 cn.javass.chapter7.web.controller.DataFormatTestController 中 。 


如 果 我 们 请 求 参 数 数据 不 能 被 正确 解析 并 绑 定 或 输入 的 数据 不 合法 等 该 怎么 处 理 呢 ? 接 下 来 
的 一 节 我 们 来 学 习 下 绑 定 失败 处 理 和 数据 验证 相关 知识 。 


SpringMVC 数 据 验 证 一 一 第 七 章 注解 式 控制 器 的 
数据 验证 、 类 型 转换 及 格式 化 一 一 跟着 开 涛 学 
SpringMVC 


7.4、 数 据 验 证 


7.4.1、 编 程式 数据 验证 


Spring 2.x 提 供 了 编程 式 验 证 支持 ， 详 见 【4.16.2 数据 验证 】 章 节 ， 在 此 我 们 重 写 
【4.16.2.4.1、 编 程式 验证 器 】 一 节 示 例 。 


(1、 验 证 器 实现 
复制 cn.javass.chapter4.web.controller.support.validator.UserModelValidator 
到 cn.javass.chapter7.web.controller.support.validator.UserModelValidator 。 
(2、 控 制 器 实现 


@Controller 
public class RegisterSimpleFormController { 
private UserModelValidator validator = new UserModelValidator(); 


@ModelAttribute("user" //G) 暴露 表单 引用 对 象 为 模型 数据 
public UserModel getUser() { 
return new UserModel(); 


@RequestMapping(value = "/validator", method = RequestMethod .GET) 
public String showRegisterForm() {  //@ 表单 展示 
return "validate/registerAndValidator"; 


@RequestMapping(value = "/validator", method = RequestMethod.POST) 
public String submitForm( 
@ModelAttribute("user") UserModel user, 
Errors errors) { //(B) 表单 提交 
validator.validate(user，errors); //1 调用 UserModelValidator 的 validate 方 法 进行 验证 
if(errors.hasErrors()) { //2 如 果 有 错误 再 回 到 表单 展示 页 面 
return showRegisterForm(); 


return "redirect:/success"; 


HME 


在 submitForm 方 法 中 ， 我 们 首先 调用 之 前 写 的 UserModelValidator 的 validate 方 法 进行 验证 ， 
当然 此 处 可 以 直接 验证 并 通过 Errors 接 口 来 保留 错误 ; 此 处 还 通过 Errors 接 口 的 hasErrors 方 
法 来 决定 当 验 证 失败 时 显示 的 错误 页 面 。 


(3、spring 配 置 文件 chapter7-servlet.xml 


<bean cJlass="cn,javass,chapter7.web.controller.RegisterSimpJeFormCcontroller"/> 


(4、 错 误 码 配置 (messages.properties) ， 需 要 执行 NativeToAscii 
直接 将 【springmvc-chapter4】 项 目 中 src 下 的 messages.properties 复 制 到 src 目 录 下 。 


在 spring 配 置 文件 chapter7-servlet .xml 中 添加 messageSource : 


<bean id="messageSource" 
class="org.springframework.context.support.ReloadableResourceBundleMessageSource"> 
<property name="basename" value="classpath:messages"/> 
<property name="fileEncodings" value="utf-8"/> 
<property name="cacheSeconds" value="120"/> 
</bean> 


(5、 视 图 页 面 (/WEB-INF/jsp/registerAndValidatorjsp ) 


直接 将 【springmvc-chapter4】 项 目 中 的 /WEB-INF/jsp/registerAndValidator.jsp 复 制 到 当前 项 
目下 的 /WEB-INF/jsp/validate/registerAndValidator.jsp。 


(6、 启 动 服务 器 测试 : 


在 浏览 器 地 址 栏 输入 http:Wlocalhost:9080/springmvc-chapter7/validator 进 行 测试 ， 测 试 步 又 
和 【4.16.2.4.1、 编 程式 验证 器 】 一 样 。 
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其 他 编程 式 验证 的 使 用 ， 请 参考 【4.16.2 数据 验证 】 章 节 


7.4.2、 声 明 式 数据 验证 
Spring3 开 始 支持 JSR-303 验 证 框架 ，JSR-303 支 持 XML 风 格 的 和 注解 风格 的 验证 ， 接 下 来 我 
们 首先 看 一 下 如 何 和 Spring 集 成 。 
7.4.2.1、 集 成 

(1、 添 加 jar 包 

此 处 使 用 Hibernate-validator 实 现 (版 本 : hibernate-validator-4.3.0.Final-dist.zip) ， 将 如 下 
jar 包 添加 到 classpath (WEB-INF/lib 下 即 可 ) 


写 道 dist/lib/required/validation-api-1.0.0.GA.jar JSR-303 规 范 API 包 dist/hibernate-validator- 
4.3.0.Final.jar Hibernate 参考 实现 


(2、 在 Spring 配置 总 添加 对 JSR-303 验 证 框架 的 支持 


<!-- 以 下 validator ConversionService 在 使 用 mvc:annotation-driven 会 自动 注册 - -> 

<bean id="validator" 

class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean"> 
<property name="providerClass" value="org.hibernate.validator.HibernateValidator 
<1-- 如 果 不 加 默认 到 使 用 classpath 下 的 ValidationMessages.properties --> 
<property name="validationMessageSource" ref="messageSource"/> 

</bean> 


男 和 











此 处 使 用 Hibernate validator 实 现 : 


validationMessageSource 属 性 : 指定 国际 化 错误 消息 从 哪里 取 ， 此 处 使 用 之 前 定义 的 
messageSource 来 获取 国际 化 消息 ; th 定 该 属性 ， 则 上 默认 到 classpath 下 的 
ValidationMessages.properties 取 国际 化 错误 消息 。 


通过 ConfigurableWebBindinglnitializer 注 册 validator : 


<bean id="webBindingInitializer" 
class="org.springframework.web.bind.support.ConfigurablewebBindingInitializer"> 
<property name="conversionService" ref="conversionService"/> 
<property name="validator" ref="validator"/> 
</bean> 


其 他 配置 和 之 前 学 习 7.2.2.4 一 节 一 样 。 


如 上 集成 过 程 看 起 来 比较 麻烦 ， 后 边 我 们 会 介绍 <mvc:annotation-driven> 和 
@EnableWebMvc，ConversionService 会 自动 注册 ， 后 续 章 节 再 详细 介绍 。 


(3、 使 用 JSR-303 验 证 框架 注解 为 模型 对 象 指定 验证 信息 


package cn.javass.chapter7.model; 

Import javax.validation.constraints.NotNull; 

public class UserModel] { 
@NotNull(message="{username.not.empty}") 
private String username; 


通过 @NotNull 指 定 此 username 字 段 不 允许 为 室 ， 当 验证 失败 时 将 从 之 前 指定 的 
messageSource 中 获取 “username.not.empty" 对 于 的 错误 信息 ， 此 处 只 有 通过 所 错误 消息 键 
值 " 格 式 指定 的 才能 从 messageSource 获 取 。 


package cn.javass.chapter7 .web.controller .validate; 
// 省 略 import 
@Controller 
public class HelloworldController { 
@RequestMapping("/validate/hello") 
public String validate(@Valid @ModelAttribute("user") UserModel user, Errors errors) 


if(errors.hasErrors()) { 
return "validate/error"; 
} 


return "redirect:/success"; 
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过 在 命令 对 象 上 注解 @Valid 来 告诉 Spring MVC 此 命令 对 象 在 绑 定 完毕 后 需要 进行 JSR-303 
验证 ， 如 果 验 证 失败 会 将 错误 信息 添加 到 errors 错 误 对 象 中 。 


(5、 验 证 失败 后 需要 展示 的 页 面 (/WEB-INF/jsp/validate/errorjsp ) 


<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 
<%@taglib prefix="form" uri="http://www.springframework.org/tags/form" %> 


<form:form commandName="Uuser"> 
<form:errors path="*" cssStyle="color:red"></form:errors><br/> 
</form:form> 


(6、 测 试 


在 浏览 US ANAL ehapler elle ， 即 没有 
username 数 据 ， 请 求 后 将 直接 到 验证 失败 界面 并 显示 错误 消息 "用户 名 不 能 为 空 ， 如 果 请 求 
时 带 上 “?username=zhang” 将 重 定向 到 成 功 页 面 。 


到 此 集成 就 完成 ， 接 下 来 我 们 详细 学 习 下 有 哪些 验证 约束 注解 吧 。 


7.4.2.2、 内 置 的 验证 约束 注解 


内 置 的 验证 约束 注解 如 下 表 所 示 (摘自 hibernate validator reference ) 





验证 注解 的 元 素 值 
@AssertFalse Boolean,boolean 验 证 注解 的 元 素 值 
元 false 
上 验证 孕 的 ] 元 吉 
@AssertTrue Boolean,boolean oT 注解 的 元 素 值 
元 true 
闻 、 六 玲 二 解 的 元 素 值 
和 王 意 类 型 例证 竺 解 
@NotNull 任意 类 型 | 
@Null 任意 类 型 验证 注解 的 元 素 值 
是 null 


BigDecimal ，Biglnteger byte,short， 


@Min(value= 值 ) 


@Max (value= 值 ) 


@DecimalMin(value= 


值 ) 


@Decimal Max(value= 


值 ) 


@Digits(integer= 整 数 
位 数 , fraction= 小 数位 


数 ) 
@Size(min= 下 限 ， 


max= 上 限 ) 


@Past 


@Future 


@NotBlank 


@Length(min= 下 限 ， 
max= 上 限 ) 


@NotEmpty 


int, long， 等 任何 Number 或 
CharSequence (存储 的 是 数字 ) 子 类 


型 


和 @Min 要 求 一 样 


和 @Min 要 求 一 样 


和 @Min 要 求 一 样 


和 @Min 要 求 一 样 


字符 串 、Collection、Map、 数 组 等 


java.util.Date,java.util.Calendar;Joda 


Time 类 库 的 日 期 类 型 


与 @Past 要 求 一 样 


CharSequence 子 类 型 


CharSequence 子 类 型 


CharSequence 子 类 型 、Collection、 
Map、 数 组 


大 于 等 于 @Min 指 定 
的 value 值 


验证 注解 的 元 素 值 
小 于 等 于 @Max 指 
定 的 value 值 


验证 注解 的 元 素 值 
大 于 等 于 @ 
DecimalMin 指 定 的 
value 值 


验证 注解 的 元 素 值 
小 于 等 于 @ 
DecimalMax 指 定 的 
Value 值 


验证 注解 的 元 素 值 
的 整数 位 数 和 人 小数 
位 数 上 限 


验证 注解 的 元 素 值 
的 在 min 和 max ( 包 
含 ) 指定 区 间 之 

内 ， 如 字符 长 度 、 
集合 大 小 


验证 注解 的 元 素 值 
(日 期 类 型 ) 比 当 
前 时 间 旱 


验证 注解 的 元 素 值 
(日 期 类 型 ) 比 当 
前 时 间 晚 


验证 注解 的 元 素 值 
不 为 室 (不 为 null、 
去 除 首位 空格 后 长 
度 为 0) ， 不 同 于 
@NotEmpty ， 
@NotBlank 只 应 用 
于 字符 串 且 在 比较 
时 会 去 除 字 符 串 的 
首位 空格 


验证 注解 的 元 素 值 
长 度 在 min 和 max 区 
间 内 


验证 注解 的 元 素 值 
不 为 null 且 不 为 空 
(字符 串 长 度 不 为 
0、 集 合 大 小 不 为 
0) 


@Range(min= 最 小 值 ， ”BigDecimal,Biglnteger,CharSequence， ”验证 注解 的 元 素 值 


max= 最 大 值 ) byte, short, int, long 等 原子 类 型 和 包装 在 最 小 值 和 最 大 值 
类 型 之 间 
验证 注解 的 元 素 值 


@Email(regexp= 正 则 吕 | 
表达 式 ,flag= 标 志 的 模 ， CharSequence 子 类 型 (如 String ) SN As 
式 ) 过 regexp 和 flag 指 定 

自 定义 的 email 格 式 


@Pattern(regexp= 正 验证 注解 的 元 素 值 
则 表达 式 ,flag= 标 志 的 String， 任 何 CharSequence 的 子 类 型 与 指定 的 正则 表达 
模式 ) 式 匹 配 


指定 递归 验证 关联 
的 对 象 ; 如 用 户 对 
象 中 有 个 地 址 对 象 
属性 ， 如 果 想 在 验 

@Valid 任何 非 原子 类 型 证 用 户 对 象 时 一 起 
验证 地 址 对 象 的 
话 ， 在 地 址 对 象 上 
加 @Valid 注 解 即 可 
级 联 验 证 


此 处 只 列 出 Hibernate Validator 提 供 的 大 部 分 验证 约束 注解 ， 请 参考 hibernate validator 官 方 文 
档 了 解 其 他 验证 约束 注解 和 进行 自 定义 的 验证 约束 注解 定义 。 


具体 演示 实例 请 参考 
cn.javass.chapter7.web.controllervalidate.ValidatorAnnotation TestController ° 
7.4.2.3 错误 消 息 


当 验 证 出 错时 ， 我 们 需要 给 用 户 展示 错误 消息 告诉 用 户 出 错 的 原因 ， 因 此 我 们 要 为 验证 约束 
注解 指定 错误 消息 。 错 误 消 息 是 通过 在 验证 约束 注解 的 message 属 性 指定 。 验 证 约束 注解 指 
定 错误 消息 有 如 下 两 种 方式 : 

1、 硬 编码 错误 消息 ; 

2、 从 资源 消息 文件 中 根据 消息 键 读 取 错 误 消 息 。 

一 、 硬 编码 错误 消息 


直接 在 验证 约束 注解 上 指定 错误 消息 ， 如 下 所 示 : 


@NotNull(message = "用 户 名 不 能 为 空 " 

@Length(min=5，max=20，message=" 用 户 名 长 度 必 须 在 5-20 之 问 ") 

@Pattern(regexp = "^[a-zA-Z_]\\w{4,19}$"，message = "用 户 名 必须 以 字母 下 划 线 开头 ， 可 由 字母 数字 下 妈 
private String username ; 


本 Eee 


如 上 所 示 ， 错 误 消息 使 用 硬 编码 指定 ， 这 种 方式 是 不 推荐 使 用 的 ， 因 为 在 如 下 场景 是 不 适用 
的 : 








1、 在 国际 化 场景 下 ， 需 要 对 不 同 的 国家 显示 不 同 的 错误 消息 ; 

2、 需 要 更 换 错误 消息 时 是 比较 麻烦 的 ， 需 要 找到 相应 的 类 进行 更 换 ， 并 重新 编译 发 布 。 
二 、 从 资源 消息 文件 中 根据 消息 键 读 取 错误 消息 

2.1、 上 默认 的 错误 消息 文件 及 默认 错误 消息 键 值 


默认 的 错误 消息 文件 是 /org/hibernate/validator/ValidationMessages.properties， 如 下 图 所 
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YalidatiorIlessages Properties 
ValidationMessaees cs, Properties 
ValidationNessages de. propertles 
ValidationNessaeges en propertles 
ValidationNessages es. properties 
ValidationMessages_fr, properties 
ValidationMessages_ hu properties 
Validationmessaees mn MH. properties 
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Yalidatiorlessages_pt_BR_ properties 
各 dationMessaees tr, properties 


ValidationmMessaees zh CH, properties ey _ 
默认 的 错误 消息 键 值 如 下 图 所 示 : 


javax.validation.constraints.AssertFalse.message = must be false 
javax.validation.constraints.AssertTrue.message = must be true 
javax.validation.constraints.DecimalMax.message = must be less than or equal to {value} 
javax.validation.constraints.DecimalMin.message = must be greater than or equal to {value} 


javax.validation.constraints.Digits.message = numeric value out of bounds [<{integer} digits>.<{fraction} digits> expected] 
javax.validation.constraints.Future.message ~ = must be in the future 
javax.validation.constraints.Max.message = must be less than or equal to {value} 
javax.validation.constraints.Min.message = must be greater than or equal to {value} 
javax.validation.constraints.NotNull.message = may not be null 
javax.validation.constraints.Null.message = must be null 
javax.validation.constraints.Past.message = must be in the past 
javax.validation.constraints.Pattern.message = must match "{regexp}" 
javax.validation.constraints.Size.message = Size must be between {min} and {max} 

省 略 部 分 消息 键 值 


消息 键 默认 为 : 验证 约束 注解 的 全 限定 类 名 .message 


在 我 们 之 前 的 测试 文件 中 ， 错 误 消息 键 值 是 使 用 默认 的 ， 如 何 自 定 义 错误 消息 文件 和 错误 消 
息 键 值 呢 ? 


2.2、 自 定义 的 错误 消息 文件 和 错误 消息 键 值 


自 定义 的 错误 消息 文件 里 的 错误 消息 键 值 将 覆盖 默认 的 错误 消息 文件 中 的 错误 消息 键 值 。 我 
们 自 定义 的 错误 消息 文件 是 具有 国际 化 功能 的 。 

(1、 定 义 错误 消息 文件 
在 类 装载 路 径 的 根 下 创建 ValidationMessages.properties 文 件 ， 如 在 src 目录 下 创建 会 自动 复制 


到 类 装载 路 径 的 根 下 ， 并 添加 如 下 消息 键 值 (需要 native2ascii， 可 以 在 eclipse 里 装 Properties 
Editor， 自 动 保存 为 ASCII 码 ) 


在 类 装载 路 径 的 根 下 创建 ValidationMessages.properties 文 件 ， 如 在 src 目 录 下 创建 会 自动 复制 
到 类 装载 路 径 的 根 下 ， 并 添加 如 下 消息 键 值 (需要 native2ascii， 可 以 在 eclipse 里 装 Properties 
Editor， 自 动 保 存 为 ASCII 码 ) 


javax.validation.constraints.Pattern.message= 用 户 名 必须 以 字母 或 下 划 线 开头 ， 后 边 可 以 跟 字 母 数字 下 划 
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需要 在 你 的 spring 配 置 文件 WEB-INF/chapter7-servlet.xml 修 改 之 前 的 validator Bean : 


<bean id="validator" 

class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean"> 
<property name="providerClass" 

value="org.hibernate.validator.HibernateVvalidator"/> 

</bean> 


此 时 错误 消息 键 值 的 查找 会 先 到 classpath 下 ValidationMessages.properties 中 找 ， 找 不 到 再 到 
默认 的 错误 消息 文件 中 找 。 


输入 测试 地 址 : http://localhost:9080/springmvc-chapter7/validate/pattern?value=zhan， 将 看 
到 我 们 自 定义 的 错误 消息 显示 出 来 了 。 


(2、 使 用 Spring 的 MessageSource Bean 进 行 消息 键 值 的 查找 
如 果 我 们 的 环境 是 与 spring 集 成 ， 还 是 应 该 使 用 Spring 提供 的 消息 支持 ， 具 体 配 置 如 下 : 


在 spring 配 置 文件 WEB-INF/chapter7-servlet.xml 定 义 MessageSource Bean : 


<bean id="messageSource" 
class="org.springframework.context.support.ReloadableResourceBundleMessageSource"> 
<property name="basename" value="classpath:messages"/> 
<property name="fileEncodings" value="utf-8"/> 
<property name="cacheSeconds" value="120"/> 
</bean> 


之 前 我 们 已 经 配置 过 了 ， 在 此 就 不 详 述 了 。 
在 spring 配 置 文件 WEB-INF/chapter7-servlet.xml 定 义 的 validator Bean， 添 加 如 下 属性 


<property name="validationMessageSource" ref="messageSource"/> 


验证 失败 的 错误 消息 键 值 的 查找 将 使 用 messageSource Bean 进 行 。 


在 消息 文件 src/messages.properties 中 添加 如 下 错误 消息 : 


javax.validation.constraints.Pattern.message= 用 户 名 必须 以 字母 或 下 划 线 开头 ， 后 边 可 以 跟 字 母 数 字 下 划 4 
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验证 错误 注解 简单 类 名 .字段 名 
验证 错误 注解 简单 类 名 .字段 类 型 全 限定 类 名 
验证 错误 注解 简单 类 名 


使 用 的 优先 级 是 : 从 高 到 低 ， 即 最 前 边 的 具有 最 高 的 优先 级 ， 而 且 以 上 所 有 默认 的 错误 消息 
键 优 先 级 高 于 自 定 义 的 错误 消息 键 。 


如 测试 用 例 cn.javass.chapter7.web.controller.validate.ValidatorAnnotationTestController 中 的 
public String pattern(@Valid @ModelAttribute("model" PatternModel model, Errors errors) 将 
自动 产生 如 下 错误 消息 键 : 


Pattern.model.value= 验 证 错误 注解 简单 类 名 .验证 对 象 名 .字段 名 
Pattern.value= 验 证 错误 注解 简单 类 名 .字段 名 
Pattern.java.lang.String= 验 证 错误 注解 简单 类 名 .字段 类 型 全 限定 类 名 
Pattern= 验 证 错误 注解 简单 类 名 

(3、 自 定义 错误 消息 键 值 


之 前 我 们 已 经 学 习 了 硬 编码 错误 消息 ， 及 默认 的 错误 消息 ， 在 大 部 分 场景 下 ， 以 上 两 种 方式 
无 法 满足 我 们 的 需求 ， 因 此 我 们 需要 自 定义 错误 消息 键 值 。 


在 验证 约束 注解 上 指定 错误 消息 键 : 


package cn.javass.chapter7 .web.controller .validate.model; 

public class PatternModel 区 
@Pattern(regexp = "^[a-zA-Z_][\\w]{4,19}$", message="{user.name.error}") 
private String value; 


我 们 可 以 通过 验证 约束 注解 的 message 届 性 指定 错误 消息 键 ， 格 式 如 {消息 键 ”。 
在 消息 文件 src/messages.properties 中 添加 如 下 错误 消息 : 


User .name.error= 用 户 名 格式 不 合法 


输入 测试 地 址 : http://localhost:9080/springmvc-chapter7/validate/pattern?value=zhan， 将 看 
到 我 们 自 定义 的 错误 消息 显示 出 来 了 。 


接 下 来 我 们 看 下 如 下 场景 


@Length(min=5, max=20, message="{user.name.length.error}") 


user .name .error= 用 户 名 长 度 必须 在 5-20 之 间 


错误 消息 中 的 5-20 应 该 是 从 @Length 验 证 约束 注解 中 获取 的 ， 而 不 是 在 错误 消息 中 硬 编码 ， 
此 我 们 需要 占 位 符 的 支持 : 


e 如 @Length(min=5, max=20, message="{user.name.length.error})")， 错 误 消 息 可 以 这 样 写 : 
用 户 名 长 度 必须 在 {min}-{max} 之 间 


错误 消息 占 位 符 规则 : 


{ 验 证 注解 属性 名 }， 如 @Length 有 min 和 max 属 性 ， 则 在 错误 消息 文件 中 可 以 通过 {min} 和 
{max} 来 获取 ; 如 @Max 有 value 属 性 ， 则 在 错误 消息 文件 中 可 以 通过 {value} 来 获取 。 


user ,name, length,error= 用 户 名 长 度 必 须 在 {min}-{max} 之 间 


输入 测试 地 址 : http:Wlocalhost:9080/springmvc-chapter7/validate/length?value=1， 将 看 到 我 
们 自 定 义 的 错误 消息 显示 出 来 了 。 


7.4.2.4、 功 能 处 理 方法 上 多 个 验证 参数 的 处 理 


当 我 们 在 一 个 功能 处 理 方法 上 需要 验证 多 个 模型 对 象 时 ， 需 要 通过 如 下 形式 来 获取 验证 结 
果 : 


@RequestMapping("/validate/multi") 

public String multi( 
@Valid @ModelAttribute("a") A a, BindingResult aErrors, 
@Valid @ModelAttribute("b") B b, BindingResult bErrors) { 


if(aErrors.hasErrors()) { // 如 果 a 模 型 对 象 验证 失败 
return "validate/error"; 


} 

if(bErrors.hasErrors()) { // 如 果 a 模 型 对 象 验证 失败 
return "validate/error"; 

} 


return "redirect:/success"; 


每 一 个 模型 对 象 后 边 都 需要 跟 一 个 Errors 或 BindingResult 对 象 来 保存 验证 结果 ， 其 方法 体内 部 
可 以 使 用 这 两 个 验证 结果 对 象 来 选择 出 错时 跳 转 的 页 面 。 详 见 
cn.javass.chapter7.web.controllervalidate.MultiModelController 。 


在 错误 页 面 ， 需 要 针对 不 同 的 模型 来 显示 错误 消息 : 


<form:form commandName="a"> 

<form:errors path="*" cssStyle="color:red"></form:errors><br/> 
</form:form> 
<form:form commandName="b"> 

<form:errors path="*" cssStyle="color:red"></form:errors><br/> 
</form:form> 


